हमारा सुझाव है कि Wear OS ऐप्लिकेशन, फ़ोन के बिना भी काम करें. इससे उपयोगकर्ता, Android या iOS फ़ोन के बिना भी स्मार्टवॉच पर टास्क पूरे कर पाएंगे. अगर स्मार्टवॉच के लिए बने आपके ऐप्लिकेशन को फ़ोन से कनेक्ट करने की ज़रूरत पड़ती है, तो आपको Wear OS ऐप्लिकेशन को स्टैंडअलोन के तौर पर मार्क नहीं करना चाहिए. साथ ही, आपको यह पक्का करना चाहिए कि उपयोगकर्ता के पास फ़ोन ऐप्लिकेशन उपलब्ध हो.
अपने ऐप्लिकेशन के लिए प्लान बनाना
Android ऐप्लिकेशन बंडल का इस्तेमाल करके, एक ही ऐप्लिकेशन लिस्टिंग में हर उपयोगकर्ता के डिवाइस कॉन्फ़िगरेशन के लिए, ऑप्टिमाइज़ किए गए Android पैकेज किट (APK) अपने-आप जनरेट किए जा सकते हैं. इससे उपयोगकर्ता सिर्फ़ वह कोड और संसाधन डाउनलोड कर पाते हैं जो आपके ऐप्लिकेशन को चलाने के लिए ज़रूरी हैं.
Google Play Store के ज़रिए ऐप्लिकेशन उपलब्ध कराने के लिए, उसे सेट अप करने के बारे में जानकारी पाने के लिए, Wear OS ऐप्लिकेशन को पैकेज करना और उपलब्ध कराना लेख पढ़ें. साथ ही, Android ऐप्लिकेशन बंडल का इस्तेमाल शुरू करने के लिए गाइड देखें.
नए ऐप्लिकेशन के लिए, टारगेट एपीआई लेवल 34 या इसके बाद का होना चाहिए. ज़्यादा जानकारी के लिए, Google Play के टारगेट एपीआई लेवल की ज़रूरी शर्तें पूरी करना लेख पढ़ें. सबसे नए एपीआई लेवल को टारगेट करने से, यह पक्का करने में मदद मिलती है कि आपका ऐप्लिकेशन, प्लैटफ़ॉर्म के मौजूदा वर्शन पर अच्छी तरह से काम करे.
नेटवर्क के अनुरोधों और हाई-बैंडविड्थ नेटवर्क ऐक्सेस के बारे में जानकारी पाने के लिए, Wear OS पर नेटवर्क ऐक्सेस और सिंक करना लेख पढ़ें.
किसी ऐप्लिकेशन को Wear OS ऐप्लिकेशन के तौर पर तय करना
आपको अपने ऐप्लिकेशन की Android मेनिफ़ेस्ट फ़ाइल में,
<uses-feature> टैग को तय करना होगा.
यह बताने के लिए कि यह स्मार्टवॉच के लिए ऐप्लिकेशन है, इस तरह की एंट्री जोड़ें:
<uses-feature android:name="android.hardware.type.watch" />
यह पहचान करना कि कोई ऐप्लिकेशन स्टैंडअलोन है या नहीं
स्मार्टवॉच के लिए ऐप्लिकेशन को स्टैंडअलोन या नॉन-स्टैंडअलोन माना जाता है:
- स्टैंडअलोन: यह पूरी तरह से स्वतंत्र ऐप्लिकेशन होता है. इसकी मुख्य सुविधाओं को इस्तेमाल करने के लिए, फ़ोन ऐप्लिकेशन की ज़रूरत नहीं होती. हालांकि, "फ़ोन पर खोलें" प्रॉम्प्ट स्वीकार किए जाते हैं, लेकिन ऐप्लिकेशन को उपयोगकर्ताओं को ऐप्लिकेशन के फ़ंक्शन को पूरा करने के लिए अन्य विकल्प उपलब्ध कराने चाहिए. जैसे, शॉर्टलिंक या क्यूआर कोड. इसके लिए, टेदर किए गए फ़ोन पर निर्भर रहने की ज़रूरत नहीं है.
- नॉन-स्टैंडअलोन: यह एक ऐसा ऐप्लिकेशन होता है जो मुख्य सुविधाओं के लिए, फ़ोन या किसी दूसरे डिवाइस पर मौजूद ऐप्लिकेशन पर निर्भर करता है. यह विकल्प उन ऐप्लिकेशन के लिए सबसे सही है जो किसी मुख्य फ़ंक्शन को पूरा करने के लिए, आसानी से कोई दूसरा तरीका उपलब्ध नहीं करा सकते. जैसे, पुष्टि करने के लिए क्यूआर कोड या छोटा लिंक.
ध्यान दें: स्टैंडअलोन ऐप्लिकेशन न होने पर भी, उपयोगकर्ता मोबाइल ऐप्लिकेशन से पहले Wear OS ऐप्लिकेशन इंस्टॉल कर सकते हैं. इसलिए, अगर आपके Wear OS ऐप्लिकेशन को पता चलता है कि आस-पास मौजूद हैंडहेल्ड डिवाइस में ज़रूरी कंपैनियन ऐप्लिकेशन नहीं है, तो उपयोगकर्ता को कंपैनियन ऐप्लिकेशन इंस्टॉल करने के लिए कहें.
ऐप्लिकेशन दिखाने के दौरान, Google इस बात की पुष्टि करता है कि ऐप्लिकेशन का स्टैंडअलोन स्टेटस सही है या नहीं. इस वैल्यू से, Play Store में ऐप्लिकेशन दिखने पर असर पड़ता है. ऐसा उन डिवाइसों पर होता है जो किसी दूसरे डिवाइस से कनेक्ट नहीं होते. जैसे, Wear OS डिवाइस जो हैंडहेल्ड डिवाइसों से जुड़े नहीं होते. नॉन-स्टैंडअलोन ऐप्लिकेशन और ऐसे ऐप्लिकेशन जिन्हें डेवलपर ने गलती से "स्टैंडअलोन" के तौर पर मार्क किया है, वे इन अनटेथर्ड डिवाइसों पर उपयोगकर्ताओं के लिए उपलब्ध नहीं होते.
अपने Wear OS ऐप्लिकेशन में, Android मेनिफ़ेस्ट फ़ाइल में
meta-data एलिमेंट com.google.android.wearable.standalone की वैल्यू सेट करें. इससे यह पता चलेगा कि आपका ऐप्लिकेशन स्टैंडअलोन है या नहीं.
अगर स्मार्टवॉच के लिए आपका ऐप्लिकेशन पूरी तरह से स्वतंत्र और अलग से मौजूद ऐप्लिकेशन है, तो Google Play Store को इसकी जानकारी दें. इसके लिए, com.google.android.wearable.standalone की वैल्यू को true पर सेट करें:
<meta-data android:name="com.google.android.wearable.standalone" android:value="true" />
अगर स्मार्टवॉच के लिए बना आपका ऐप्लिकेशन स्टैंडअलोन नहीं है और मुख्य सुविधाओं के लिए किसी दूसरे ऐप्लिकेशन पर निर्भर है, तो
com.google.android.wearable.standalone की वैल्यू को
false पर सेट करें. इसका मतलब है कि स्मार्टवॉच के लिए ऐप्लिकेशन को किसी दूसरे डिवाइस की ज़रूरत होती है. हालांकि, इससे Google Play Store पर आपके ऐप्लिकेशन प्रमोशन पर कोई असर नहीं पड़ता.
ध्यान दें:
अगर com.google.android.wearable.standalone की वैल्यू
false है, तो भी
फ़ोन ऐप्लिकेशन इंस्टॉल होने से पहले, स्मार्टवॉच के लिए ऐप्लिकेशन इंस्टॉल किया जा सकता है.
इसलिए, अगर स्मार्टवॉच के लिए आपके ऐप्लिकेशन को पता चलता है कि साथ काम करने वाले फ़ोन में ज़रूरी फ़ोन ऐप्लिकेशन मौजूद नहीं है, तो उपयोगकर्ता को फ़ोन ऐप्लिकेशन इंस्टॉल करने के लिए कहें. इस पेज पर, फ़ोन ऐप्लिकेशन के बारे में बताया गया है.
शेयर किया गया कोड और डेटा स्टोरेज
Wear OS ऐप्लिकेशन और फ़ोन ऐप्लिकेशन के बीच कोड शेयर किया जा सकता है. उदाहरण के लिए, नेटवर्किंग के लिए सामान्य कोड, शेयर की गई लाइब्रेरी में हो सकता है.
इसके अलावा, किसी खास डिवाइस के नाप या आकार के लिए कोड को अलग मॉड्यूल में रखा जा सकता है.
डेटा को डिवाइस पर सेव करने के लिए, स्टैंडर्ड Android स्टोरेज एपीआई का इस्तेमाल किया जा सकता है. ठीक उसी तरह जैसे फ़ोन पर किया जाता है. की-वैल्यू पेयर और टाइप किए गए ऑब्जेक्ट को सेव करने के लिए, DataStore का इस्तेमाल किया जा सकता है. इसके अलावा, रूम परसिस्टेंस लाइब्रेरी का भी इस्तेमाल किया जा सकता है.
किसी दूसरे डिवाइस पर अपने ऐप्लिकेशन का पता लगाना
स्मार्टवॉच के लिए ऐप्लिकेशन और फ़ोन ऐप्लिकेशन, दोनों यह पता लगा सकते हैं कि दूसरा ऐप्लिकेशन उपलब्ध है या नहीं.
आपके फ़ोन और स्मार्टवॉच के ऐप्लिकेशन, जोड़े गए डिवाइस को अपनी मौजूदगी की जानकारी देने के लिए, CapabilityClient का इस्तेमाल कर सकते हैं. वे ऐसा स्टैटिक या डाइनैमिक तरीके से कर सकते हैं.
जब कोई ऐप्लिकेशन उपयोगकर्ता के Wear OS नेटवर्क के किसी नोड पर होता है, जैसे कि फ़ोन, जोड़े गए डिवाइस या क्लाउड पर, तो CapabilityClient अन्य ऐप्लिकेशन को इसका पता लगाने की अनुमति देता है. ज़्यादा जानकारी के लिए,
कैपेबिलिटी क्लाइंट का इस्तेमाल करके खास डिवाइसों को ढूंढना लेख पढ़ें.
अगर आपका कोई ऐप्लिकेशन दूसरे ऐप्लिकेशन का पता नहीं लगा पाता है, तो उपयोगकर्ता को उस डिवाइस पर Play Store पेज खोलने के लिए कहा जा सकता है जिस पर ऐप्लिकेशन काम नहीं कर रहा है. यह स्मार्टवॉच के लिए बने उन ऐप्लिकेशन के लिए एक समाधान है जिन्हें ठीक से काम करने के लिए, फ़ोन में मौजूद साथी ऐप्लिकेशन की ज़रूरत होती है.
आपको यह देखना होगा कि डिवाइस पर Play Store उपलब्ध है या नहीं. ऐसा इसलिए, क्योंकि सभी फ़ोन पर Play Store काम नहीं करता. जैसे, iPhone.
यहां दिए गए सेक्शन में, दो स्थितियों के लिए सबसे सही तरीके बताए गए हैं:
- स्मार्टवॉच के लिए अलग से मौजूद ऐप्लिकेशन को फ़ोन ऐप्लिकेशन की ज़रूरत होती है.
- आपके फ़ोन ऐप्लिकेशन को स्मार्टवॉच के लिए स्टैंडअलोन ऐप्लिकेशन की ज़रूरत है.
डेटा लेयर हेल्पर सैंपल की भी समीक्षा की जा सकती है. इससे पता चलता है कि Horologist के हिस्से, डेटा लेयर हेल्पर लाइब्रेरी का इस्तेमाल कैसे किया जाता है. इन हेल्पर की मदद से, हैंडहेल्ड डिवाइस और Wear OS डिवाइस के बीच के कनेक्शन को मॉनिटर किया जा सकता है.
यहां दिए गए सेक्शन में बताई गई क्लास के बारे में ज़्यादा जानकारी के लिए, Wear OS API का रेफ़रंस देखें.
इस रेफ़रंस में,
PhoneTypeHelper क्लास के बारे में भी जानकारी शामिल है. इसमें
getPhoneDeviceType() तरीका शामिल है. इसकी मदद से, आपका
Wear OS ऐप्लिकेशन यह पता लगा सकता है कि साथ में इस्तेमाल किया जाने वाला फ़ोन, Android डिवाइस है या iOS डिवाइस.
अपने ऐप्लिकेशन का पता लगाने के लिए, क्षमता के नाम बताएं
हर डिवाइस टाइप (स्मार्टवॉच या फ़ोन) के हिसाब से बने ऐप्लिकेशन के लिए, res/values/wear.xml फ़ाइल में क्षमता के नाम के लिए एक यूनीक स्ट्रिंग तय करें.
उदाहरण के लिए, आपके मोबाइल मॉड्यूल में, wear.xml फ़ाइल में ये शामिल हो सकते हैं:
<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@array/android_wear_capabilities"> <string-array name="android_wear_capabilities"> <item>verify_remote_example_phone_app</item> </string-array> </resources>
आपके Wear OS मॉड्यूल में, wear.xml फ़ाइल में क्षमता के नाम के लिए अलग वैल्यू शामिल है. जैसे:
<resources xmlns:tools="http://schemas.android.com/tools" tools:keep="@array/android_wear_capabilities"> <string-array name="android_wear_capabilities"> <item>verify_remote_example_wear_app</item> </string-array> </resources>
ज़्यादा जानकारी के लिए, कैपेबिलिटी क्लाइंट का इस्तेमाल करके खास डिवाइसों को ढूंढना लेख पढ़ें.
ऐप्लिकेशन का पता लगाना और स्मार्टवॉच से यूआरएल खोलना
स्मार्टवॉच के लिए बना आपका ऐप्लिकेशन यह पता लगा सकता है कि उपयोगकर्ता के फ़ोन पर, फ़ोन के लिए बना आपका ऐप्लिकेशन मौजूद है या नहीं. इसके लिए, यह तरीका अपनाएं:
-
CapabilityClientका इस्तेमाल करके देखें कि जोड़े गए फ़ोन पर, फ़ोन ऐप्लिकेशन इंस्टॉल है या नहीं. ज़्यादा जानकारी के लिए, GitHub पर डेटालेयर हेल्पर का सैंपल देखें. -
अगर फ़ोन पर Phone ऐप्लिकेशन इंस्टॉल नहीं है, तो फ़ोन का टाइप देखने के लिए,
PhoneDeviceType.getPhoneDeviceType()तरीके का इस्तेमाल करें. ज़्यादा जानकारी के लिए, यहां मौजूद सेक्शन देखें. -
अगर
PhoneDeviceType.DEVICE_TYPE_ANDROIDदिखता है, तो इसका मतलब है कि फ़ोन एक Android फ़ोन है. फ़ोन पर Play Store खोलने के लिए,RemoteActivityHelper.startRemoteActivity()को Wear OS डिवाइस पर कॉल करें. अपने फ़ोन ऐप्लिकेशन के लिए मार्केट यूआरआई का इस्तेमाल करें. यह आपके Wear ऐप्लिकेशन के यूआरआई से अलग हो सकता है. उदाहरण के लिए, मार्केट यूआरआई का इस्तेमाल करें, जैसे कि:market://details?id=com.example.android.wearable.wear.finddevices. -
अगर
PhoneDeviceType.DEVICE_TYPE_IOSदिखता है, तो इसका मतलब है कि फ़ोन iOS है और उस पर Play Store उपलब्ध नहीं है. Wear OS डिवाइस परRemoteActivityHelper.startRemoteActivity()को कॉल करके, iPhone पर App Store खोलें. अपने ऐप्लिकेशन का iTunes यूआरएल डाला जा सकता है. जैसे,https://itunes.apple.com/us/app/yourappname.Wear OS से, प्रोग्राम के हिसाब से यह पता नहीं लगाया जा सकता कि आपका फ़ोन ऐप्लिकेशन, iOS डिवाइस पर इंस्टॉल है या नहीं. सबसे सही तरीके के तौर पर, उपयोगकर्ता को मैन्युअल तरीके से ऐप स्टोर खोलने की सुविधा दें.
ध्यान दें: पिछले सेक्शन में बताए गए तरीके से RemoteActivityHelper एपीआई का इस्तेमाल करें. इससे यह तय किया जा सकेगा कि स्मार्टवॉच से फ़ोन पर कोई भी यूआरएल खोला जा सकता है और इसके लिए, फ़ोन ऐप्लिकेशन की ज़रूरत नहीं है.
जोड़े गए फ़ोन के टाइप का पता लगाने के लिए जानकारी
यहां एक स्निपेट दिया गया है, जिसमें getPhoneDeviceType() तरीके का इस्तेमाल करके यह पता लगाया गया है कि स्मार्टवॉच को किस तरह के फ़ोन से जोड़ा गया है:
var phoneDeviceType: Int = PhoneTypeHelper.getPhoneDeviceType(this)
getPhoneDeviceType() तरीके से मिली वैल्यू, इनमें से कोई एक होती है:
| रिटर्न वैल्यू | ब्यौरा |
|---|---|
DEVICE_TYPE_ANDROID
|
साथी फ़ोन, Android पर चलने वाला डिवाइस हो. |
DEVICE_TYPE_IOS
|
कंपैनियन फ़ोन एक iOS डिवाइस हो. |
DEVICE_TYPE_UNKNOWN
|
साथी फ़ोन एक अनजान डिवाइस है. |
DEVICE_TYPE_ERROR
|
जोड़े गए फ़ोन के टाइप का पता लगाने में कोई गड़बड़ी हुई. बाद में फिर से जांच की जानी चाहिए. |
Android फ़ोन से ऐप्लिकेशन का पता लगाने की सुविधा शुरू करना
आपका Android फ़ोन यह पता लगा सकता है कि किसी उपयोगकर्ता के Wear OS डिवाइस पर, स्मार्टवॉच के लिए बना आपका ऐप्लिकेशन मौजूद है या नहीं. इसके लिए, यह तरीका अपनाएं:
-
NodeClientका इस्तेमाल करके, उपयोगकर्ता के फ़ोन से कनेक्ट की गई सभी स्मार्टवॉच ढूंढें. ज़्यादा जानकारी के लिए, GitHub पर डेटालेयर हेल्पर का सैंपल देखें. -
CapabilityClientका इस्तेमाल करके, देखें कि उपयोगकर्ता की किस स्मार्टवॉच पर आपका ऐप्लिकेशन इंस्टॉल है. -
अगर आपका ऐप्लिकेशन उपयोगकर्ता की सभी स्मार्टवॉच पर इंस्टॉल नहीं है, तो उपयोगकर्ता को
RemoteActivityHelper.startRemoteActivity()तरीके का इस्तेमाल करके, फ़ोन से बाकी Wear OS डिवाइसों पर Play Store खोलने दें. Wear OS ऐप्लिकेशन के लिए, मार्केट यूआरआई का इस्तेमाल करें. यह आपके फ़ोन ऐप्लिकेशन के यूआरआई से अलग हो सकता है. उदाहरण के लिए, मार्केट यूआरआई का इस्तेमाल करें, जैसे कि:market://details?id=com.example.android.wearable.wear.finddevices.
iPhone से जोड़े गए स्मार्टवॉच के लिए जगह की जानकारी का डेटा
iPhone से जोड़ी गई स्मार्टवॉच पर जगह की जानकारी का डेटा पाने के लिए, कई तरह से जांची गई सही जगह की जानकारी देने वाला एपीआई (एफ़एलपी) का इस्तेमाल करें. ज़्यादा जानकारी के लिए, Wear OS पर जगह की जानकारी का पता लगाना लेख पढ़ें.
अगर साथी फ़ोन उपलब्ध है, तो एफ़एलपी जगह की जानकारी के डेटा के लिए साथी फ़ोन का इस्तेमाल करता है.
सिर्फ़ ज़रूरी डेटा इकट्ठा करना
आम तौर पर, इंटरनेट से डेटा लेते समय सिर्फ़ ज़रूरी डेटा ही लें. ऐसा न करने पर, हो सकता है कि आपके ऐप्लिकेशन में बेवजह इंतज़ार का समय बढ़ जाए, मेमोरी का इस्तेमाल बढ़ जाए, और बैटरी का इस्तेमाल बढ़ जाए.
जब कोई स्मार्टवॉच ब्लूटूथ स्मार्ट कनेक्शन से कनेक्ट होती है, तो आपके ऐप्लिकेशन के पास स्मार्टवॉच के हिसाब से, सिर्फ़ चार किलोबाइट प्रति सेकंड की बैंडविड्थ का ऐक्सेस हो सकता है. इसलिए, हमारा सुझाव है कि आप यह तरीका अपनाएं:
- अपने नेटवर्क के अनुरोधों और जवाबों की जांच करें, ताकि आपको उस अतिरिक्त डेटा के बारे में पता चल सके जिसकी ज़रूरत सिर्फ़ फ़ोन ऐप्लिकेशन के लिए होती है.
- बड़ी इमेज को स्मार्टवॉच पर भेजने से पहले, उनका साइज़ छोटा कर लें.
जिन मामलों में ज़्यादा बैंडविड्थ वाले नेटवर्क की ज़रूरत होती है उनके लिए, ज़्यादा बैंडविड्थ वाले नेटवर्क का ऐक्सेस देखें.
अन्य कोड सैंपल
डेटालेयर हेल्पर सैंपल से, इस पेज पर बताए गए एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी मिलती है.