इस पेज का अनुवाद Cloud Translation API से किया गया है.

चीन के लिए Wear OS ऐप्लिकेशन बनाएं

चीन के लिए Wear OS ऐप्लिकेशन बनाते समय, आपको उन हैंडसेट का ध्यान रखना होगा जिनमें Google Play की सेवाएं पहले से इंस्टॉल नहीं हैं. इस पेज में ऐसे सामान्य बदलाव बताए गए हैं जिन्हें डेवलपर को चीन के बाज़ार के लिए अपनाना पड़ सकता है.

Google Play services का सही वर्शन इस्तेमाल करना

Google Play services के वर्शन 10.2.0 में, दुनिया भर में फ़्यूज़्ड लोकेशन प्रोवाइडर एपीआई और डेटा लेयर एपीआई का इस्तेमाल किया जा सकता है. अगर आपको इन एपीआई का इस्तेमाल करना है, तो आपको Google Play services के इस वर्शन का इस्तेमाल करना होगा. इससे, आपको चीन में Wear OS वाले ज़्यादा से ज़्यादा डिवाइसों के साथ काम करने की सुविधा मिलेगी. अन्य मामलों में, यह डिपेंडेंसी ज़रूरी नहीं है.

ध्यान दें: Google Play services में, Wear OS ऐप्लिकेशन के लिए एपीआई मौजूद हैं. हालांकि, चीन के लिए बनाए गए Wear OS ऐप्लिकेशन को GoogleApiClient से जुड़े एपीआई का इस्तेमाल करना जारी रखना चाहिए. ज़्यादा जानकारी के लिए, Wearable API को ऐक्सेस करना लेख पढ़ें.

कई तरह से जांची गई सही जगह की जानकारी देने वाला एपीआई

अगर Fused लोकेशन प्रोवाइडर एपीआई का इस्तेमाल किया जाता है, तो अपने Wear OS मॉड्यूल की build.gradle फ़ाइल में इस डिपेंडेंसी को शामिल करें:

Groovy

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-location:10.2.0'
}

Kotlin

dependencies {
    ...
    implementation("com.google.android.gms:play-services-location:10.2.0")
}

Data Layer API

ध्यान दें: डेटा लेयर एपीआई सिर्फ़ Android फ़ोन और Wear OS स्मार्टवॉच के साथ मैसेज भेज सकता है और डेटा को सिंक कर सकता है. अगर आपका Wear OS डिवाइस, किसी iOS डिवाइस से जोड़ा गया है, तो डेटा लेयर एपीआई काम नहीं करेगा.

इस वजह से, नेटवर्क से संपर्क करने के मुख्य तरीके के तौर पर, डेटा लेयर एपीआई का इस्तेमाल न करें. इसके बजाय, अपने Wear OS ऐप्लिकेशन में वही पैटर्न अपनाएं जो मोबाइल ऐप्लिकेशन में अपनाया जाता है. हालांकि, इसमें कुछ छोटे-मोटे अंतर हो सकते हैं. इनके बारे में Wear OS पर नेटवर्क ऐक्सेस और सिंक करने की सुविधा में बताया गया है.

अगर आपका ऐप्लिकेशन, Data Layer API का इस्तेमाल करता है, तो आपको अपने Wear OS मॉड्यूल की build.gradle फ़ाइल में यह लाइन जोड़नी होगी. इस लाइन के लिए, क्लाइंट लाइब्रेरी के 10.2.0 वर्शन का इस्तेमाल करना ज़रूरी है.

Groovy

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
    ...
}

Kotlin

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
    ...
}

अपने मोबाइल मॉड्यूल की build.gradle फ़ाइल में यह लाइन जोड़ें. Google Play services की डिपेंडेंसी को 10.2.0 वर्शन के रेफ़रंस से बदलें.

Groovy

dependencies {
    ...
    implementation 'com.google.android.gms:play-services-wearable:10.2.0'
}

Kotlin

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:10.2.0")
}

पुष्टि करना

पुष्टि करने की सुविधा लागू करने से पहले, इस्तेमाल के उदाहरणों की समीक्षा करें. इससे यह पता चलेगा कि पुष्टि करने की ज़रूरत है या नहीं. उदाहरण के लिए, मौसम का पूर्वानुमान बताने वाले ऐप्लिकेशन के लिए, शायद साइन इन न करना पड़े और पुष्टि करने की ज़रूरत न पड़े.

अगर आपको पुष्टि करने की ज़रूरत है, तो हमारा सुझाव है कि आप AndroidX Oauth लाइब्रेरी का इस्तेमाल करें. इसके लिए, पीकेसीई के साथ ऑथराइज़ेशन कोड फ़्लो का इस्तेमाल करना ज़रूरी है. स्मार्टवॉच पर पुष्टि करने के तरीके में बताए गए किसी अन्य तरीके का भी इस्तेमाल किया जा सकता है. हमारा सुझाव है कि Wearable Support Library का इस्तेमाल न करें.

ज़्यादा जानकारी के लिए, GitHub पर Wear OS OAuth सैंपल देखें.

ब्रिज की गई सूचनाएं

ब्रिज की गई सूचनाएं, चीन में काम नहीं करतीं. फ़ोन की सूचनाएं, Wear OS पर सिर्फ़ तब भेजी जाती हैं, जब Wear OS डिवाइस, ब्लूटूथ की मदद से फ़ोन से कनेक्ट हो.

जगह और मैपिंग निर्देशांक के साथ काम करना

चीन में उपयोगकर्ता की जगह की जानकारी का पता लगाने के लिए, FusedLocationProvider (एफ़एलपी) का इस्तेमाल करें. ठीक वैसे ही जैसे बाकी दुनिया के लिए किया जाता है. इससे यह पक्का होता है कि आपका ऐप्लिकेशन सबसे अच्छी जानकारी का इस्तेमाल करता है. भले ही, स्मार्टवॉच के हार्डवेयर और उससे कनेक्ट किए गए फ़ोन के प्लैटफ़ॉर्म में कोई फ़र्क़ क्यों न हो. FLP का इस्तेमाल करने पर, Wear OS प्लैटफ़ॉर्म में पहले से मौजूद बैटरी ऑप्टिमाइज़ेशन भी जुड़ जाता है.

FusedLocationProvider को तीसरे पक्ष के मैप SDK टूल के साथ इंटिग्रेट करते समय, सेवा देने वाली कंपनियों के बीच निर्देशांक की सुविधा के काम करने के तरीके का ध्यान रखें. FusedLocationProvider, जगह की जानकारी को WGS84 स्टैंडर्ड के हिसाब से रिपोर्ट करता है. ज़रूरत के हिसाब से, निर्देशांक सिस्टम बदलना न भूलें.

Google Fit से जुड़ी सहायता

Google Fit के इंस्टॉल किए गए कदमों, मूव मिनट, और हार्ट पॉइंट की सुविधा चीन में काम करती है. यह सुविधा चीन के लिए अब तक के सात दिनों तक के इतिहास के साथ काम करती है. उपयोगकर्ता क्रेडेंशियल दिए बिना भी इसे ऐक्सेस किया जा सकता है.

बोलकर फ़ोन का इस्तेमाल करने की सुविधा से जुड़ी सहायता

Wear OS प्लैटफ़ॉर्म, उपयोगकर्ता की कार्रवाइयों के आधार पर कई वॉइस इंटेंट उपलब्ध कराता है. जैसे, _"दिल की गति दिखाएं"_ या _"अलार्म सेट करें"_. इससे उपयोगकर्ताओं को यह बताने में मदद मिलती है कि उन्हें क्या करना है. साथ ही, सिस्टम को यह तय करने में मदद मिलती है कि कौनसी गतिविधि शुरू की जाए.

जब उपयोगकर्ता बोलकर कोई कार्रवाई करते हैं, तो आपका ऐप्लिकेशन उस इंटेंट को फ़िल्टर कर सकता है जिससे कोई गतिविधि शुरू की जाती है. बैकग्राउंड में कोई सेवा शुरू करने के लिए, विज़ुअल क्यू के तौर पर कोई गतिविधि दिखाएं और उस गतिविधि में सेवा शुरू करें. विज़ुअल क्यू से छुटकारा पाने के लिए, finish() को कॉल करना न भूलें.

Wear OS प्लैटफ़ॉर्म पर काम करने वाले वॉइस इंटेंट की सूची यहां दी गई है:

कैटगरी	उदाहरण	इंटेंट स्पेसिफ़िकेशन
कैब बुक करने की सुविधा	打车去三里屯	कार्रवाई `com.google.android.gms.actions.RESERVE_TAXI_RESERVATION` अतिरिक्त `to`: पहचाना गया डेस्टिनेशन यह अतिरिक्त जानकारी देना ज़रूरी नहीं है.
अलार्म सेट करें	कल सुबह सात बजे का अलार्म सेट करना	कार्रवाई `android.intent.action.SET_ALARM` अतिरिक्त सुविधाएं `android.provider.AlarmClock.EXTRA_HOUR`: अलार्म के घंटे की जानकारी देने वाला पूर्णांक `android.provider.AlarmClock.EXTRA_MINUTES`: अलार्म के मिनट की वैल्यू ये अतिरिक्त सुविधाएं ज़रूरी नहीं हैं. इनमें से कोई एक, दोनों या दोनों में से कोई भी नहीं दें.
टाइमर सेट करें	3 मिनट का काउंटडाउन सेट करना	कार्रवाई `android.intent.action.SET_TIMER` अतिरिक्त सुविधाएं `android.provider.AlarmClock.EXTRA_LENGTH`: यह टाइमर की अवधि दिखाने वाला पूर्णांक होता है. यह 1 से 86400 (24 घंटे में सेकंड की संख्या) के बीच का होता है
स्टॉपवॉच प्रारंभ करें	开始计时	कार्रवाई `com.google.android.wearable.action.STOPWATCH`
साइकल चलाना शुरू या बंद करना	राइड शुरू करना	कार्रवाई `vnd.google.fitness.TRACK` MIME टाइप `vnd.google.fitness.activity/biking` अतिरिक्त सुविधाएं `actionStatus`: शुरू होने पर `ActiveActionStatus` और बंद होने पर `CompletedActionStatus` वैल्यू वाली स्ट्रिंग
रन शुरू या बंद करना	开始跑步	कार्रवाई `vnd.google.fitness.TRACK` MIME टाइप `vnd.google.fitness.activity/running` अतिरिक्त सुविधाएं `actionStatus`: शुरू होने पर `ActiveActionStatus` और बंद होने पर `CompletedActionStatus` वैल्यू वाली स्ट्रिंग
कसरत शुरू या बंद करना	开始锻炼	कार्रवाई `vnd.google.fitness.TRACK` MIME टाइप `vnd.google.fitness.activity/other` अतिरिक्त सुविधाएं `actionStatus`: शुरू होने पर `ActiveActionStatus` और बंद होने पर `CompletedActionStatus` वैल्यू वाली स्ट्रिंग
धड़कन की दर दिखाना	ह्रदय की गति देखना	कार्रवाई `vnd.google.fitness.VIEW` MIME टाइप `vnd.google.fitness.data_type/com.google.heart_rate.bpm`
कदमों की संख्या दिखाएं	步数	कार्रवाई `vnd.google.fitness.VIEW` MIME टाइप `vnd.google.fitness.data_type/com.google.step_count.cumulative`
नेविगेशन	导航去Chrome里屯	कार्रवाई `android.intent.action.VIEW` डेटा भौगोलिक:अक्षांश,देशांतर?q=設科资讯中心

जहां भी लागू हो, Voice Assistant कुछ खास तरह की कार्रवाइयों को ट्रिगर करने के लिए, मौजूदा Android के सामान्य इंटेंट का भी इस्तेमाल कर सकती है.

एम्युलेटर से जुड़ी सहायता

अपने ऐप्लिकेशन की जांच करने के लिए, Wear OS एम्युलेटर इमेज के चीन के वर्शन का इस्तेमाल किया जा सकता है. यह सुविधा, Android Studio 3.0 और इसके बाद के वर्शन पर काम करती है.

एम्युलेटर के चीन वर्शन पर अपने ऐप्लिकेशन की जांच करने के लिए, यह तरीका अपनाएं:

Android एम्युलेटर इंस्टॉल करें.
SDK मैनेजर से, 'चीन के लिए Wear OS' की इमेज डाउनलोड करें. Wear OS 3.5 (एपीआई लेवल 30) के लिए उपलब्ध वर्शन का इस्तेमाल करें.
एवीडी प्रोफ़ाइल बनाते समय, चीन के लिए Wear OS इमेज चुनें.
ऐप्लिकेशन डेवलप करने के लिए, 'चीन के लिए Wear OS' एम्युलेटर चलाएं.

पहली इमेज. Wear OS एम्युलेटर के चीन के वर्शन के उदाहरण.

Wear OS एम्युलेटर के इस वर्शन में, पहले से इंस्टॉल किए गए कई ऐप्लिकेशन मौजूद होते हैं:

आस-पास की आवाज़ सुनाने वाला मोड
संपर्क
Google हस्तलेखन इनपुट
Google Play सेवाएं
Wear OS के लिए स्वास्थ्य से जुड़ी सेवाएं
एलई डिवाइसों के लिए, हॉटवर्ड की पहचान करने की सुविधा
पिनयिन
Play Store (चीन में इस्तेमाल होने वाले डिवाइसों के लिए बनाया गया)
पॉकेटवॉच
TalkBack
स्मार्ट वॉच की होम स्क्रीन (एनालॉग और डिजिटल, दोनों वर्शन)
Wear की मुख्य सेवाएं

किसी ऐप्लिकेशन के लिए ब्लूटूथ और वाई-फ़ाई चैनल शुरू करना

Wear OS, नेटवर्क के अनुरोधों को अपने-आप रूट करता है. ज़्यादातर मामलों में, ऐप्लिकेशन को कोई खास ब्लूटूथ और वाई-फ़ाई चैनल खोलने की ज़रूरत नहीं होती.

अगर कोई ऐप्लिकेशन चीन में, ऐप्लिकेशन के हिसाब से ब्लूटूथ और वाई-फ़ाई चैनल का अनुरोध करता है, तो अनुरोध चुपचाप अस्वीकार कर दिया जाता है. इसके बजाय, एक डायलॉग दिखता है, जिसमें उपयोगकर्ता से पुष्टि करने के लिए कहा जाता है. पुष्टि करने पर, चैनल खुल जाता है. ऐसा हर बार होता है, सिर्फ़ पहली बार इस्तेमाल करने पर नहीं. BluetoothAdapter.enable() या WifiManager.setEnabled(true) को कॉल किया जाता है.

ध्यान दें: Android 10 (एपीआई लेवल 29) या इसके बाद के वर्शन WifiManager.setEnabled() को टारगेट करने वाले ऐप्लिकेशन को कॉल करने के लिए, यह कोई सिस्टम ऐप्लिकेशन या डिवाइस नीति कंट्रोलर (डीपीसी) होना चाहिए.

अनुमति की समीक्षा करने का मोड

चीन में, Wear OS for China डिवाइसों पर अनुमति की समीक्षा मोड चालू रहता है. इस मोड में, targetApiLevel 23 से कम वाले ऐप्लिकेशन इस्तेमाल करने पर कुछ पाबंदियां लागू होती हैं. इन सीमाओं की समीक्षा करें:

इंस्टॉल करते समय अनुमतियां दी जाती हैं. हालांकि, जब targetApiLevel 23 से कम वाला ऐप्लिकेशन पहली बार शुरू होता है, तो एक डायलॉग बॉक्स दिखता है. इसमें उपयोगकर्ता से इस ऐप्लिकेशन के लिए अनुमतियों की पुष्टि करने के लिए कहा जाता है.
ऐप्लिकेशन में मौजूद कॉम्पोनेंट, जैसे कि ब्रॉडकास्ट रिसीवर, सेवाएं, और गतिविधियां, ऐप्लिकेशन को पहली बार इस्तेमाल करने से पहले, उनसे जुड़े इवेंट का जवाब नहीं देते.

इसलिए, हमारा सुझाव है कि आप targetApiLevel 23 या इसके बाद के वर्शन का इस्तेमाल करें और ऐप्लिकेशन अनुमतियों के सबसे सही तरीकों का इस्तेमाल करें.

Google Play services के अन्य एपीआई का इस्तेमाल करना

अगर आपका ऐप्लिकेशन, Wearable API के अलावा Google Play services के एपीआई का इस्तेमाल करता है, तो आपके ऐप्लिकेशन को यह देखना होगा कि रनटाइम के दौरान ये एपीआई इस्तेमाल किए जा सकते हैं या नहीं. साथ ही, ये एपीआई सही तरीके से काम करेंगे या नहीं. Google Play services API की उपलब्धता देखने के दो तरीके हैं:

दूसरे एपीआई से कनेक्ट करने के लिए, किसी अलग GoogleApiClient इंस्टेंस का इस्तेमाल करें. इस इंटरफ़ेस में कॉलबैक होते हैं, ताकि आपके ऐप्लिकेशन को कनेक्शन के काम या काम न करने की सूचना दी जा सके. कनेक्शन न होने पर, ConnectionResult के बजाय API_UNAVAILABLE दिखता है. कनेक्शन न हो पाने की समस्याओं को ठीक करने का तरीका जानने के लिए, Google API ऐक्सेस करना देखें.
ज़रूरी एपीआई से कनेक्ट करने के लिए, GoogleApiClient.Builder के addApiIfAvailable() तरीके का इस्तेमाल करें. onConnected() कॉलबैक ट्रिगर होने के बाद, hasConnectedApi() तरीके का इस्तेमाल करके पक्का करें कि अनुरोध किए गए हर एपीआई को सही तरीके से कनेक्ट किया गया हो.

चीन में ऐप्लिकेशन उपलब्ध कराना

चीन के लिए Wear OS के उपयोगकर्ताओं तक असरदार तरीके से पहुंचने के लिए, तीसरे पक्ष के Wear OS ऐप्लिकेशन स्टोर के ज़रिए अपने ऐप्लिकेशन उपलब्ध कराए जा सकते हैं. जैसे:

Samsung डिवाइसों के लिए Galaxy Store
Xiaomi डिवाइसों के लिए Xiaomi Store
अन्य सभी डिवाइसों के लिए Mobvoi