Commissioning API का इस्तेमाल करके, आपके ऐप्लिकेशन में कमीशनिंग फ़्लो को दो तरीकों से शुरू किया जा सकता है: सीधे आपके ऐप्लिकेशन में या Fast Pair प्रोसेस में ऐप्लिकेशन पिकर के ज़रिए. इस सेक्शन में, हर तरीके के लिए उपयोगकर्ता अनुभव (यूएक्स) के बारे में बताया गया है.
ऐप्लिकेशन ने शुरू किया
इस स्थिति में, उपयोगकर्ता आपके ऐप्लिकेशन में डिवाइस को चालू करने की प्रोसेस शुरू करता है. आम तौर पर, यह प्रोसेस "डिवाइस जोड़ें" कॉल-टू-ऐक्शन (सीटीए) से शुरू होती है. हमारा सुझाव है कि डिवाइस जोड़ें बटन को इस तरह दिखाया जाए:
- जहां उपयोगकर्ताओं को उनके सभी डिवाइस दिखते हैं, जैसे कि कंट्रोल पेज
- जहां उपयोगकर्ता, होम को मैनेज कर सकते हैं. जैसे, सेटिंग पेज
- आपके ऐप्लिकेशन का होम पेज
कमीशनिंग पूरी होने के बाद, हमारा सुझाव है कि उपयोगकर्ता को ऐप्लिकेशन के होम पेज पर ले जाएं. इसके अलावा, ऐप्लिकेशन में उस जगह पर भी ले जाया जा सकता है जहां उपयोगकर्ता को, अभी-अभी सेट अप किया गया डिवाइस कंट्रोलर दिखे. इसके अलावा, सभी डिवाइसों की पूरी सूची भी दिखाई जा सकती है. इसमें, अभी-अभी सेट अप किया गया डिवाइस भी शामिल है.
यूएक्स को दूसरी इमेज में दिखाया गया है:
ऐप्लिकेशन का उपयोगकर्ता, डिवाइस जोड़ें पर क्लिक करता है.
उपयोगकर्ता, क्यूआर कोड स्कैन करता है या जोड़ने के लिए कोड डालता है.
उपयोगकर्ता को डिवाइस को Google फ़ैब्रिक में जोड़ने के लिए सहमति देने के लिए कहा जाता है. यह इमेज 1 में "सहमति + मेटाडेटा" से मेल खाता है. साथ ही, उसे इस्तेमाल करने के लिए Google खाता चुनने के लिए कहा जाता है.
अगर उपयोगकर्ता के पास एक से ज़्यादा होम हैं, तो उसे कोई होम चुनने के लिए कहा जाता है. अगर उन्होंने कोई होम सेट अप नहीं किया है, तो "होम" नाम का एक होम अपने-आप बन जाता है.
कमीशनिंग एपीआई, डिवाइस से कनेक्ट होता है.
उपयोगकर्ता को उस कमरे को चुनने के लिए कहा जाता है जहां डिवाइस मौजूद है.
उपयोगकर्ता को डिवाइस का नाम बदलने के लिए कहा जाता है.
कमीशनिंग एपीआई, Matter क्रेडेंशियल जनरेट करता है. इसके बाद, नेटवर्क कनेक्टिविटी की जांच करता है. फिर, कमीशनिंग की प्रोसेस पूरी करता है. इस प्रोसेस में, डिवाइस को चुने गए फ़ैब्रिक से कनेक्ट किया जाता है.
अगर उपयोगकर्ता के स्ट्रक्चर और डिवाइसों को ऐक्सेस करने की अनुमति पहले ही दी जा चुकी है, तो डिवाइस को Home में दिखना चाहिए. साथ ही, उस Home में मौजूद अन्य डिवाइसों के साथ दिखना चाहिए. इसे ऐप्लिकेशन का इस्तेमाल करके कंट्रोल किया जा सकता है.
अगर उपयोगकर्ता के स्ट्रक्चर और डिवाइसों का ऐक्सेस नहीं दिया गया है, तो डिवाइस को ऐप्लिकेशन में नहीं दिखना चाहिए. साथ ही, उसे ऐप्लिकेशन से कंट्रोल नहीं किया जा सकेगा. किसी ऐप्लिकेशन में डिवाइस को ऐक्सेस करने और कंट्रोल करने के लिए, अनुमति ज़रूरी है.
फ़ास्ट पेयर की सुविधा के ज़रिए शुरू किया गया
Android में फ़ास्ट पेयर का इस्तेमाल करके भी कमीशनिंग शुरू की जा सकती है. डिवाइस के Matter क्यूआर कोड को स्कैन करने के बाद, उपयोगकर्ता को कमीशनिंग की प्रोसेस जारी रखने के लिए कोई ऐप्लिकेशन चुनने के लिए कहा जाता है. आपका ऐप्लिकेशन चुनने पर, ऐप्लिकेशन के Commissioning API का इस्तेमाल किया जाता है. इसे तीसरे डायग्राम में दिखाया गया है.
अगर उपयोगकर्ता ने अपने मोबाइल डिवाइस पर ऐप्लिकेशन इंस्टॉल नहीं किया है, तो उसे आगे बढ़ने से पहले ऐप्लिकेशन इंस्टॉल करने के लिए कहा जाता है. ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है, वहां से आगे का उपयोगकर्ता अनुभव, इमेज 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 पर भेजा जाता है, ताकि वह ऐप्लिकेशन इंस्टॉल कर सके. इसके बाद ही, वह आगे बढ़ सकता है.