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

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

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

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

ध्यान दें: Google Play services में Wear OS ऐप्लिकेशन के लिए एपीआई शामिल हैं. हालांकि, चीन में Wear OS ऐप्लिकेशन को GoogleApiClient से जुड़े एपीआई का इस्तेमाल जारी रखना चाहिए. इसके बारे में जानने के लिए, Wearable 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 का इस्तेमाल करता है, तो आपको 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 2.0 लाइब्रेरी का इस्तेमाल करें. इसके लिए, पीकेसीई के साथ ऑथराइज़ेशन कोड ग्रांट फ़्लो का इस्तेमाल करना ज़रूरी है. वियरेबल डिवाइसों पर पुष्टि करना लेख में बताए गए किसी दूसरे तरीके का भी इस्तेमाल किया जा सकता है. 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: पहचान किया गया डेस्टिनेशन

यह अतिरिक्त जानकारी देना ज़रूरी नहीं है.
अलार्म सेट करें 设置一个明早七点的闹钟

कार्रवाई

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. एसडीके मैनेजर से, चीन में Wear OS के लिए उपलब्ध इमेज डाउनलोड करें. Wear OS 3.5 (एपीआई लेवल 30) के लिए उपलब्ध वर्शन का इस्तेमाल करें.
  3. AVD प्रोफ़ाइल बनाते समय, Wear OS for China की इमेज चुनें.
  4. डेवलपमेंट के लिए, Wear OS for China के एम्युलेटर को चलाएं.

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

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

  • आस-पास की आवाज़ सुनाने वाला मोड
  • संपर्क
  • Google हस्तलेखन इनपुट
  • Google Play सेवाएं
  • Wear OS के लिए स्वास्थ्य सेवाएं
  • एलई डिवाइसों के लिए हॉटवर्ड पहचानने की सुविधा
  • पिनयिन
  • Play Store (चीन में उपलब्ध डिवाइसों के लिए)
  • Pocketwatch
  • 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 ऐप्लिकेशन स्टोर के ज़रिए ऐप्लिकेशन डिस्ट्रिब्यूट किया जा सकता है. जैसे: