डेटा लेयर एपीआई के बारे में खास जानकारी

क्लाउड-आधारित नोड को Google के सर्वर से कंट्रोल किया जाता है
पहली इमेज. हैंडहेल्ड और Wear OS डिवाइस.

पहने जाने वाला डेटा लेयर एपीआई, जो Google Play services का हिस्सा है, पहने जाने वाले डिवाइसों (जैसे, स्मार्टवॉच) और कनेक्ट किए गए हैंडहेल्ड डिवाइस (आम तौर पर, स्मार्टफ़ोन). यह आपके विज्ञापनों को सिंक करने और एक डिवाइस से दूसरे डिवाइस पर डेटा ट्रांसफ़र कर सकते हैं.

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

चेतावनी: डेटा लेयर एपीआई को हैंडहेल्ड और पहने जाने वाले डिवाइसों के बीच कम्यूनिकेशन की ज़रूरत नहीं होती. आपके पास सिर्फ़ यही एपीआई हैं का इस्तेमाल इन डिवाइसों के बीच कम्यूनिकेशन सेट अप करने के लिए करें. उदाहरण के लिए, संचार चैनल बनाने के लिए निम्न-स्तरीय सॉकेट खोलें.

इस्तेमाल के सामान्य उदाहरण

'डेटा लेयर एपीआई', खास तौर पर फ़िटनेस और मीडिया के इस्तेमाल के लिए फ़ायदेमंद है.

फ़िटनेस ऐप्लिकेशन

कसरत का डेटा, Wear OS ऐप्लिकेशन से मोबाइल ऐप्लिकेशन के फ़िटनेस ऐप्लिकेशन पर भेजना अक्सर ज़रूरी होता है स्मार्टवॉच से कैप्चर किए गए कसरत के डेटा को, किसी मोबाइल ऐप्लिकेशन या Health ऐप्लिकेशन पर लिखो कनेक्ट करें. अगर डेटा ट्रांसफ़र करने के लिए डेटा लेयर एपीआई का इस्तेमाल किया जा रहा है, तो Wear OS ऐप्लिकेशन से मोबाइल ऐप्लिकेशन पर कसरत का डेटा भेजने के लिए, क्लाइंट को मैसेज भेजें पर क्लिक कर सकते हैं.

होम वर्कआउट के दौरान मोबाइल डिवाइस पर लाइव डेटा स्ट्रीम करें

घर पर कसरत करने से जुड़ा एक आम उदाहरण, Wear OS से धड़कन की दर का डेटा स्ट्रीम कर रहा है मोबाइल डिवाइस से कनेक्ट किया जा रहा है और उपयोगकर्ता को धड़कन की दर की अप-टू-डेट जानकारी दिखाई जा रही है स्क्रीन पर हाइलाइट कर सकते हैं. इस डेटा को स्ट्रीम करने के लिए, किसी चैनल क्लाइंट का इस्तेमाल करें.

मीडिया ऐप्लिकेशन

किसी मीडिया प्लेयर को फ़ोन से जुड़ने के लिए, मैसेज क्लाइंट का इस्तेमाल करें.

बातचीत के लिए विकल्प

डेटा को इनमें से किसी एक तरीके से ट्रांसफ़र किया जाता है:

  1. सीधे तौर पर, जब Wear OS डिवाइस और अन्य डिवाइस.
  2. किसी उपलब्ध नेटवर्क पर, जैसे कि LTE या वाई-फ़ाई से, Google के सर्वर पर एक मध्यस्थ के रूप में नेटवर्क नोड.

सभी डेटा लेयर क्लाइंट, ब्लूटूथ का इस्तेमाल करके या क्लाउड, अपने-आप डाउनलोड होता है. मान लें कि डेटा डेटा लेयर का इस्तेमाल करके ट्रांसमिट किया जाने वाला डेटा, कभी-कभी Google के सर्वर का इस्तेमाल कर सकता है.

ब्लूटूथ

ब्लूटूथ का इस्तेमाल करके डिवाइसों को कनेक्ट करने पर, डेटा लेयर इस कनेक्शन का इस्तेमाल करता है. दोनों डिवाइसों के बीच, एन्क्रिप्ट (सुरक्षित) किया गया एक चैनल होता है. ब्लूटूथ एन्क्रिप्शन, जिसे Google Play services मैनेज करता है.

बादल का आइकॉन

ब्लूटूथ उपलब्ध न होने पर, डेटा अपने-आप Google Cloud के ज़रिए रूट किया जाता है. Google Cloud की मदद से ट्रांसफ़र किया जाने वाला सारा डेटा, पूरी तरह सुरक्षित (E2EE) होता है.

सिक्योरिटी ऑफ़ कम्यूनिकेशन

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

  • पैकेज का नाम सभी डिवाइसों से मेल खाना चाहिए.
  • पैकेज का सिग्नेचर, सभी डिवाइसों पर मेल खाना चाहिए.

कनेक्शन टाइप पर ध्यान दिए बिना, किसी भी दूसरे ऐप्लिकेशन के पास डेटा का ऐक्सेस नहीं होता.

सेटअप

Wearable डेटा लेयर एपीआई में ये डिपेंडेंसी होती हैं:

  • Google Play services का सबसे नया वर्शन.
  • Wear OS डिवाइस या Wear OS एम्युलेटर.

अपने Wear मॉड्यूल की build.gradle फ़ाइल में, यहां दी गई डिपेंडेंसी शामिल करें:

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

दूसरे डिवाइस से जोड़ने की प्रोसेस को आसान बनाएं

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

  • किसी दूसरे डिवाइस पर ऐप्लिकेशन इंस्टॉल करें.
  • किसी अन्य डिवाइस पर ऐप्लिकेशन लॉन्च करें.
  • दूसरे डिवाइस पर कोई खास गतिविधि लॉन्च करें.
  • साथी ऐप्लिकेशन लॉन्च करें.

डेटा लेयर को ऐक्सेस करना

डेटा लेयर एपीआई को कॉल करने के लिए, Wearable क्लास का इस्तेमाल करें, ताकि क्लाइंट की अलग-अलग क्लास की जानकारी देता है, जैसे कि DataClient और MessageClient.

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

कम से कम क्लाइंट का इस्तेमाल करें

क्लाइंट बनाने के लिए, कोड का यह उदाहरण देखें:

Kotlin

val dataClient: DataClient = Wearable.getDataClient(context)

Java

DataClient dataClient = Wearable.getDataClient(context);

यह कॉन्टेक्स्ट, Android से जुड़ा कोई भी मान्य कॉन्टेक्स्ट हो सकता है. अगर एपीआई का इस्तेमाल Activity के स्कोप के लिए, Wearable में से getDataClient() तरीके का इस्तेमाल करें क्लास. इससे कुछ इंटरैक्शन, डायलॉग बॉक्स के तौर पर दिखते हैं सूचनाएं, जैसे कि उपयोगकर्ता से जब उन्हें Google का अपना वर्शन अपडेट करने के लिए कहा जाए Play सेवाएं.

डिफ़ॉल्ट रूप से, लिसनर को कॉलबैक ऐप्लिकेशन के मुख्य यूज़र इंटरफ़ेस (यूआई) थ्रेड पर बनाया जाता है. होना चाहिए दूसरे थ्रेड पर किए गए कॉलबैक, तो WearableOptions ऑब्जेक्ट का इस्तेमाल करके पसंद के मुताबिक Looper बनाएं:

Kotlin

runBlocking {
    Wearable.getDataClient(context, options)
}

Java

WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build();
DataClient dataClient = Wearable.getDataClient(context, options);

ज़्यादा जानकारी के लिए, WearableOptions.Builder रेफ़रंस देखें.

ज़रूरत के हिसाब से क्लाइंट इंस्टेंस फिर से बनाएं

DataClient और MessageClient जैसे पहने जा सकने वाले एपीआई क्लाइंट, बनाने में सस्ता पड़ता है. इसलिए क्लाइंट को होल्ड करने के बजाय, उन्हें तो आपको उनकी ज़रूरत हो सकती है.

क्लाइंट की स्थिति, सभी के बीच शेयर की जाती है. जैसे, रजिस्टर किए गए लिसनर का सेट क्लाइंट को सुरक्षित रखा जाता है. इसे तब सेव रखा जाता है, जब किसी ऐप्लिकेशन के अपडेट रहने के दौरान Google Play services अपडेट की जाती है दौड़ने.