चीन के लिए 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 का इस्तेमाल करता है, तो आपको 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: पहचान किया गया डेस्टिनेशन

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

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 के लिए 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 ऐप्लिकेशन स्टोर के ज़रिए ऐप्लिकेशन डिस्ट्रिब्यूट किया जा सकता है. जैसे: