चीन के लिए 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 Location Provider 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

अगर आपका ऐप्लिकेशन, 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: अलार्म के मिनट की वैल्यू

ये अतिरिक्त सुविधाएं ज़रूरी नहीं हैं. इनमें से कोई एक, दोनों या कोई भी जानकारी न दें.

टाइमर सेट करें तीन मिनट का काउंटडाउन सेट करना कार्रवाई

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

नेविगेशन 三里屯的导航 कार्रवाई

android.intent.action.VIEW

डेटा

geo:latitude,longitude?q=融科资讯中心

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

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

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

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

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

    5. पहली इमेज. 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 के एपीआई की उपलब्धता देखने के दो तरीके हैं:

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

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

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

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