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

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

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

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

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

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

अगर Fused Location Provider API का इस्तेमाल किया जाता है, तो 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 डिवाइस से जुड़ा है, तो Data Layer API काम नहीं करेगा.

इसलिए, नेटवर्क से कम्यूनिकेट करने के लिए, डेटा लेयर एपीआई का इस्तेमाल मुख्य तरीके के तौर पर न करें. इसके बजाय, 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) का इस्तेमाल करें. इसका इस्तेमाल, दुनिया के अन्य देशों में भी किया जाता है. इससे यह पक्का होता है कि आपका ऐप्लिकेशन, सबसे अच्छी जानकारी को ध्यान में रखता है. भले ही, स्मार्टवॉच का हार्डवेयर और स्मार्टवॉच से लिंक किया गया फ़ोन प्लैटफ़ॉर्म कोई भी हो. FLP का इस्तेमाल करने से, Wear OS प्लैटफ़ॉर्म में पहले से मौजूद बैटरी ऑप्टिमाइज़ेशन की सुविधा भी मिलती है.

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

Google Fit के साथ काम करने की सुविधा

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

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

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

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

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

कैटगरी	उदाहरण	इंटेंट स्पेसिफ़िकेशन
कार हेलिंग	打车去三里屯	कार्रवाई com.google.android.gms.actions.RESERVE_TAXI_RESERVATION ज़्यादा to: पहचान की गई मंज़िल 'extra' फ़ील्ड की वैल्यू देना ज़रूरी नहीं है.
अलार्म सेट करें	设置一个明早七点的闹钟	कार्रवाई android.intent.action.SET_ALARM अन्य सुविधाएं android.provider.AlarmClock.EXTRA_HOUR: पूर्णांक, जिसमें अलार्म का समय घंटे में दिया गया हो android.provider.AlarmClock.EXTRA_MINUTES: यह एक पूर्णांक होता है, जिसमें अलार्म का मिनट होता है इन अतिरिक्त सुविधाओं को खरीदना ज़रूरी नहीं है. इनमें से कोई एक, दोनों या कोई भी अतिरिक्त जानकारी दें.
टाइमर सेट करें	设置一个三分钟的倒计时	कार्रवाई android.intent.action.SET_TIMER अन्य सुविधाएं android.provider.AlarmClock.EXTRA_LENGTH: 1 से 86,400 के बीच का पूर्णांक (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
नेविगेशन	三里屯导航	कार्रवाई android.intent.action.VIEW डेटा geo:latitude,longitude?q=融科资讯中心

आवाज़ वाली सुविधा, Android के सामान्य इंटेंट का इस्तेमाल करके, कुछ कार्रवाइयां ट्रिगर कर सकती है. हालांकि, ऐसा सिर्फ़ उन मामलों में किया जा सकता है जहां यह सुविधा काम करती है.

एम्युलेटर की सुविधा

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

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

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


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

Wear OS के इस एम्युलेटर में, पहले से इंस्टॉल किए गए कई ऐप्लिकेशन शामिल हैं:

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

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

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

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

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

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

चीन में, Wear OS for China डिवाइसों पर Permission Review Mode काम करता है. इससे, targetApiLevel 23 से कम वाले ऐप्लिकेशन को इस्तेमाल करने पर कुछ पाबंदियां लग जाती हैं. यहां दी गई सीमाएं देखें:

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

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

Google Play services के अन्य API का इस्तेमाल करना

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

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

चीन में ऐप्लिकेशन डिस्ट्रिब्यूट करना

चीन में Wear OS का इस्तेमाल करने वाले लोगों तक आसानी से पहुंचने के लिए, तीसरे पक्ष के Wear OS ऐप्लिकेशन स्टोर के ज़रिए ऐप्लिकेशन डिस्ट्रिब्यूट किया जा सकता है. जैसे:

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