स्मार्टवॉच की होम स्क्रीन पर सूचनाएं पाने के लिए, अपने फ़ोन ऐप्लिकेशन को कॉन्फ़िगर करना

कैननिकल मार्केटप्लेस के लिए, फ़ोन ऐप्लिकेशन वह मुख्य तरीका है जिससे उपयोगकर्ता ऐप्लिकेशन के साथ इंटरैक्ट करता है.

वॉच फ़ेस सेट करना

जब उपयोगकर्ता फ़ोन ऐप्लिकेशन में कोई वॉच फ़ेस चुनता है, तो वॉच फ़ेस सेट करने के लिए, इसके बाद की प्रोसेस में दो हिस्से होते हैं:

1. इंस्टॉल करना: Watch Face Push का इस्तेमाल करके, स्मार्टवॉच की होम स्क्रीन इंस्टॉल करें. इसे MessageClient से शुरू किया जाता है. यह चरण आसान है. इसमें addWatchFace या updateWatchFace का इस्तेमाल किया जाता है. इसे फ़ोन से स्मार्टवॉच पर MessageClient का इस्तेमाल करके ट्रिगर किया जाता है.
2. ऐक्टिवेशन: इंस्टॉल किए गए वॉच फ़ेस को मौजूदा वॉच फ़ेस के तौर पर सेट करें. इस चरण में, अनुमति की स्थिति के आधार पर कई रास्ते हो सकते हैं:
   • ऐसा हो सकता है कि कोई कार्रवाई करने की ज़रूरत न हो. ऐसा हो सकता है कि मार्केटप्लेस के पास, मौजूदा वॉच फ़ेस को कंट्रोल करने का ऐक्सेस पहले से हो.
   • ऐसा हो सकता है कि उपयोगकर्ता को कुछ भी करने की ज़रूरत न पड़े. ऐप्लिकेशन के पास, मौजूदा वॉच फ़ेस को सेट करने की ज़रूरी अनुमतियां हैं. साथ ही, वह setWatchFaceAsActive() का इस्तेमाल करके सीधे तौर पर ऐसा कर सकता है.
   • आपको निर्देशों की ज़रूरत पड़ सकती है. जैसे, अनुमति के अनुरोधों को स्वीकार करने का तरीका या लंबे समय तक दबाकर रखने वाले जेस्चर या साथी ऐप्लिकेशन का इस्तेमाल करके, स्मार्ट वॉच की होम स्क्रीन को मैन्युअल तरीके से सेट करने का तरीका.

इंस्टॉल करने से जुड़ा जवाब

चालू करने के चरण को पूरा करने के लिए, इंस्टॉल करने के चरण में स्मार्टवॉच से फ़ोन पर यह जानकारी मिलनी चाहिए:

• इंस्टॉल करने की कोशिश का नतीजा
• isWatchFaceActive() का नतीजा - इससे यह तय किया जाता है कि ऐप्लिकेशन में पहले से ही मौजूदा वॉच फ़ेस है या नहीं.
• क्या setWatchFaceAsActive() को पहले ही कॉल किया जा चुका है - Wear OS ऐप्लिकेशन को इस जानकारी को ट्रैक करना चाहिए और इसे स्थानीय तौर पर सेव करके रखना चाहिए. इस एपीआई कॉल का इस्तेमाल सिर्फ़ एक बार किया जा सकता है.

रणनीति लागू करने का तरीका

इंस्टॉल करने के बाद, जवाब में यह दिख सकता है कि ऐप्लिकेशन में पहले से ही चालू वॉच फ़ेस मौजूद है. हालांकि, अगर ऐसा नहीं होता है, तो ऐप्लिकेशन वॉच फ़ेस को अपनी स्मार्टवॉच के वॉच फ़ेस के तौर पर सेट करें बटन दिखा सकता है.

पहला उदाहरण: स्मार्टवॉच के मौजूदा वॉच फ़ेस को सेट करने की सभी कोशिशें पूरी हो गई हैं

अगर इंस्टॉल करने के जवाब में यह बताया गया है कि setWatchFaceAsActive() को पहले ही कॉल किया जा चुका है, तो बटन को फ़ोन पर मौजूद शिक्षा स्क्रीन पर ले जाना चाहिए. इसमें उपयोगकर्ता को यह दिखाया जाना चाहिए कि वॉच फ़ेस पर दबाकर रखने से, उसे मैन्युअल तरीके से अपनी पसंद के हिसाब से कैसे सेट किया जा सकता है.

दूसरा तरीका - स्मार्टवॉच के मौजूदा वॉच फ़ेस को सेट करने की कोशिश करें

फ़ोन को स्मार्टवॉच को यह निर्देश देना चाहिए कि वह SET_PUSHED_WATCH_FACE_AS_ACTIVE की ज़रूरी अनुमति की जांच करे:

• अगर उपयोगकर्ता ने पहले ही अनुमति दे दी है, तो setWatchFaceAsActive() को कॉल करें.
• अगर उपयोगकर्ता ने पहले अनुमति नहीं दी है, तो स्मार्टवॉच को इस बारे में फ़ोन को बताना चाहिए. इससे फ़ोन पर एक जानकारी वाली स्क्रीन दिखाई जा सकती है. इसमें अनुमति देने की ज़रूरत के बारे में बताया जा सकता है. साथ ही, यह भी बताया जा सकता है कि अनुमति मैन्युअल तरीके से कैसे दी जा सकती है.

• अगर पहले अनुमति का अनुरोध नहीं किया गया है, तो स्मार्टवॉच को फ़ोन को यह निर्देश देना चाहिए कि वह उपयोगकर्ता को एक जानकारी वाला मैसेज दिखाए. इसमें यह बताया गया हो कि स्मार्टवॉच पर अनुमतियां स्वीकार करने का तरीका क्या है. साथ ही, स्मार्टवॉच को अनुमति का अनुरोध करना चाहिए.

  • अगर उपयोगकर्ता अनुमति देता है, तो घड़ी को setWatchFaceAsActive() को कॉल करना चाहिए.
  • इसके अलावा, स्मार्टवॉच को फ़ोन पर एक शिक्षा स्क्रीन दिखानी चाहिए. इसमें अनुमति देने की ज़रूरत के बारे में बताया गया हो. साथ ही, यह भी बताया गया हो कि मैन्युअल तरीके से अनुमति कैसे दी जाती है.