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