कमीशनिंग API का उपयोग करके आपके ऐप में कमीशनिंग प्रवाह दो तरीकों से शुरू किया जा सकता है: सीधे आपके ऐप में, या फ़ास्ट पेयर प्रक्रिया में ऐप पिकर के माध्यम से. इस सेक्शन में, हर एक के लिए उपयोगकर्ता अनुभव (यूएक्स) के बारे में बताया गया है.
ऐप्लिकेशन ने शुरू किया
इस स्थिति में, उपयोगकर्ता आपके ऐप्लिकेशन में डिवाइस को चालू करने की प्रोसेस शुरू करता है. आम तौर पर, यह प्रोसेस "डिवाइस जोड़ें" कॉल-टू-ऐक्शन (सीटीए) से शुरू होती है. हम डिवाइस जोड़ें बटन को इस प्रकार प्रदर्शित करने की अनुशंसा करते हैं:
- जहां उपयोगकर्ताओं को उनके सभी डिवाइस दिखते हैं, जैसे कि कंट्रोल पेज
- जहाँ उपयोगकर्ता होम को प्रबंधित कर सकते हैं, जैसे कि सेटिंग पेज
- आपके ऐप का होम पेज
कमीशनिंग पूरी होने के बाद, हमारा सुझाव है कि उपयोगकर्ता को ऐप्लिकेशन के होम पेज पर ले जाएं. इसके अलावा, ऐप्लिकेशन में उस जगह पर भी ले जाया जा सकता है जहां उपयोगकर्ता को अभी-अभी सेट अप किया गया डिवाइस कंट्रोलर दिखे. इसके अलावा, सभी डिवाइसों की पूरी सूची भी दिखाई जा सकती है. इसमें अभी-अभी सेट अप किया गया डिवाइस भी शामिल है.
यूज़र एक्सपीरियंस को दूसरी इमेज में दिखाया गया है:
ऐप्लिकेशन का उपयोगकर्ता, डिवाइस जोड़ें पर क्लिक करता है.
उपयोगकर्ता, क्यूआर कोड स्कैन करता है या पेयरिंग कोड डालता है.
उपयोगकर्ता को डिवाइस को Google फ़ैब्रिक में जोड़ने के लिए सहमति देने के लिए कहा जाता है. यह इमेज 1 में "सहमति + मेटाडेटा" से मेल खाता है. साथ ही, उसे इस्तेमाल करने के लिए Google खाता चुनने के लिए कहा जाता है.
अगर उपयोगकर्ता के पास एक से ज़्यादा होम हैं, तो उसे कोई होम चुनने के लिए कहा जाएगा. अगर उन्होंने कोई होम सेट अप नहीं किया है, तो "होम" नाम का होम अपने-आप बन जाता है.
कमीशनिंग एपीआई, डिवाइस से कनेक्ट होता है.
उपयोगकर्ता को उस कमरे को चुनने के लिए कहा जाता है जहां डिवाइस मौजूद है.
उपयोगकर्ता को डिवाइस का नाम बदलने के लिए कहा जाता है.
कमीशनिंग एपीआई, Matter क्रेडेंशियल जनरेट करता है. इसके बाद, नेटवर्क कनेक्टिविटी की जांच करता है. फिर, कमीशनिंग की प्रोसेस पूरी करता है. इस प्रोसेस में, डिवाइस को चुने गए फ़ैब्रिक से कनेक्ट किया जाता है.
अगर उपयोगकर्ता के होम और डिवाइसों को ऐक्सेस करने की अनुमति पहले ही दी जा चुकी है, तो डिवाइस को Home में दिखना चाहिए. साथ ही, उस Home में मौजूद अन्य डिवाइसों के साथ दिखना चाहिए. इसे ऐप्लिकेशन का इस्तेमाल करके कंट्रोल किया जा सकता है.
अगर उपयोगकर्ता के स्ट्रक्चर और डिवाइसों का ऐक्सेस नहीं दिया गया है, तो ऐप्लिकेशन में डिवाइस नहीं दिखना चाहिए. साथ ही, उसे कंट्रोल नहीं किया जा सकेगा. किसी ऐप्लिकेशन में डिवाइस को ऐक्सेस करने और कंट्रोल करने के लिए, अनुमति ज़रूरी है.
फ़ास्ट पेयर की सुविधा से शुरू किया गया
Android में फ़ास्ट पेयर की सुविधा का इस्तेमाल करके भी कमीशनिंग शुरू की जा सकती है. डिवाइस के Matter क्यूआर कोड को स्कैन करने के बाद, उपयोगकर्ता को कमीशनिंग की प्रोसेस जारी रखने के लिए, कोई ऐप्लिकेशन चुनने के लिए कहा जाता है. ऐप्लिकेशन चुनने पर, ऐप्लिकेशन से Commissioning API का इस्तेमाल किया जाता है. इसे तीसरी इमेज में दिखाया गया है.
यदि उपयोगकर्ता के मोबाइल डिवाइस पर ऐप इंस्टॉल नहीं है, तो उन्हें आगे बढ़ने से पहले इंस्टॉल करने के लिए कहा जाएगा. सहमति स्क्रीन से आगे का UX चित्र 2 के समान ही है.
उपयोगकर्ता को क्यूआर कोड स्कैन करने के लिए कहा जाता है.
उपयोगकर्ता, डिवाइस के Matter क्यूआर कोड को स्कैन करता है.
उपयोगकर्ता को कमीशनिंग की प्रोसेस जारी रखने के लिए, कोई ऐप्लिकेशन चुनने के लिए कहा जाता है.
यदि ऐप पहले से इंस्टॉल नहीं है, तो उपयोगकर्ता को इसे इंस्टॉल करने के लिए कहा जाता है.
ऐप्लिकेशन, Google Play Store से डाउनलोड होता है.
ऐप्लिकेशन इंस्टॉल है.
ऐप्लिकेशन इंस्टॉल हो जाने के बाद, उपयोगकर्ता को आगे बढ़ने के लिए कहा जाता है.
उपयोगकर्ता को डिवाइस को Google फ़ैब्रिक में जोड़ने के लिए सहमति देने के लिए कहा जाता है. यह इमेज 1 में "सहमति + मेटाडेटा" से मेल खाता है. साथ ही, उसे इस्तेमाल करने के लिए Google खाता चुनने के लिए कहा जाता है.
यदि उपयोगकर्ता के पास एक से अधिक होम हैं, तो उन्हें एक होम चुनने के लिए कहा जाएगा. यदि उनके पास कोई होम सेट अप नहीं है, तो "होम" नामक एक होम स्वचालित रूप से बना दिया जाता है.
कमीशनिंग एपीआई, डिवाइस से कनेक्ट होता है.
उपयोगकर्ता को उस कमरे को चुनने के लिए कहा जाता है जहां डिवाइस मौजूद है.
उपयोगकर्ता को डिवाइस का नाम बदलने के लिए कहा जाता है.
Commissioning API, Matter क्रेडेंशियल जनरेट करता है. इसके बाद, नेटवर्क कनेक्टिविटी की जांच करता है. फिर, कमीशनिंग की प्रोसेस पूरी करता है. इस प्रोसेस में, डिवाइस को चुने गए फ़ैब्रिक से कनेक्ट किया जाता है.
अगर उपयोगकर्ता के होम और डिवाइसों को ऐक्सेस करने की अनुमति पहले ही दी जा चुकी है, तो डिवाइस को होम में दिखना चाहिए. साथ ही, उस होम में मौजूद अन्य डिवाइसों के साथ दिखना चाहिए. इसके अलावा, डिवाइस को ऐप्लिकेशन का इस्तेमाल करके कंट्रोल किया जा सकता है.
अगर उपयोगकर्ता के डिवाइसों और स्ट्रक्चर को ऐक्सेस करने की अनुमति नहीं दी गई है, तो ऐप्लिकेशन में डिवाइस नहीं दिखना चाहिए. साथ ही, उसे कंट्रोल भी नहीं किया जा सकेगा. किसी ऐप्लिकेशन में डिवाइस को ऐक्सेस करने और कंट्रोल करने के लिए, अनुमति देना ज़रूरी है.
ऐप्लिकेशन चुनने वाला टूल
कमीशनिंग की प्रोसेस के दौरान, ऐप्लिकेशन पिकर में आपका ऐप्लिकेशन दो तरीकों से दिखता है:
- कोई ऐप्लिकेशन चुनें स्क्रीन पर.
- अगर उपयोगकर्ता कोई दूसरा ऐप्लिकेशन चुनें विकल्प चुनते हैं, तो यह इंस्टॉल किए गए अन्य ऐप्लिकेशन स्क्रीन पर दिखेगा.
सुझाए गए ऐप्लिकेशन
ऐप्लिकेशन पिकर में, सुझाए गए दो ऐप्लिकेशन दिखते हैं.
- पहली वैल्यू हमेशा Google Home app (GHA) होती है.
- दूसरा, डिवाइस बनाने वाली कंपनी के पसंदीदा ऐप्लिकेशन के लिए होता है. ऐसा तब होता है, जब इसे डिवाइस के वीआईडी या पीआईडी से जुड़े Google Home Developer Console प्रोजेक्ट में तय किया गया हो. (यह विकल्प, उन ऐप्लिकेशन डेवलपर पर लागू नहीं होता जो Matter डिवाइस नहीं बनाते.)
कोई ऐप्लिकेशन चुनें स्क्रीन पर ऐप्लिकेशन दो स्थितियों में दिखते हैं.
- इंस्टॉल किया गया - Google Play services देखें कि ऐप्लिकेशन,
ACTION_COMMISSION_DEVICEइंटेंट फ़िल्टर के साथ काम करता हो. अगर इंटेंट फ़िल्टर मौजूद नहीं है, तो उपयोगकर्ता को Play Store पर भेज दिया जाता है, ताकि वह ऐप्लिकेशन को अपडेट कर सके. - इंस्टॉल नहीं किया गया - उपयोगकर्ता को Play Store पर भेजा जाता है, ताकि वह आगे बढ़ने से पहले ऐप्लिकेशन इंस्टॉल कर सके.