Android पर असली उपयोगकर्ताओं के लिए ऑनबोर्डिंग फ़्लो

इस गाइड में, Google Home API के साथ बिना किसी रुकावट के काम करने वाले डिवाइसों के लिए, उपयोगकर्ता अनुभव से जुड़े दिशा-निर्देश दिए गए हैं. साथ ही, इसमें आपके ऐप्लिकेशन में शामिल होने के दौरान, डिवाइस की अनुमतियां और शेयर करने की सुविधा के बारे में भी बताया गया है.

यहाँ इन मुख्य विषयों के बारे में बताया गया है:

• Google Home के साथ डिवाइसों को क्यों शेयर करें?
• शेयर करने की प्रोसेस के मुख्य चरण
• तकनीकी सेटअप
• यूज़र एक्सपीरियंस (यूएक्स) के सबसे सही तरीके

Google Home के साथ डिवाइस क्यों शेयर किए जाते हैं?

Home API की सुविधाओं का इस्तेमाल करने के लिए, उपयोगकर्ताओं को अपने डिवाइस Google Home के साथ शेयर करने होंगे. इसकी वजह यह है कि:

• ऑटोमेशन में इन डिवाइसों का इस्तेमाल करने के लिए, Google को यह तकनीकी जानकारी चाहिए.
• इससे Google Home का अनुभव एक जैसा और बेहतर बना रहता है.
  • यह पक्का करना ज़रूरी है कि Home API की सुविधा वाले सभी ऐप्लिकेशन पर डिवाइसों को एक जैसा दिखाया जाए. इससे, लोगों को एक जैसा और आसान अनुभव मिलता है. अगर ऐसा नहीं किया जाता है, तो लोगों को बुनियादी काम करने के लिए अलग-अलग ऐप्लिकेशन इस्तेमाल करने पड़ सकते हैं.

शेयर करने की प्रोसेस के मुख्य कॉम्पोनेंट

कॉम्पोनेंट	कार्यक्रम	ब्यौरा
Android पर Permissions API	Android पर अनुमतियों के लिए Home APIs	यह उपयोगकर्ताओं को आपके ऐप्लिकेशन को अनुमतियां देने के लिए कहता है. Home API में से किसी का भी इस्तेमाल करने से पहले, आपके ऐप्लिकेशन के पास उपयोगकर्ता के होम (एपीआई में इसे स्ट्रक्चर कहा जाता है) में मौजूद डिवाइसों को ऐक्सेस करने की अनुमति होनी चाहिए. हालांकि, इस चरण को किस क्रम में पूरा किया जाता है, यह डेवलपर के इस्तेमाल के तरीके पर निर्भर करता है. इसके बारे में तकनीकी जानकारी में बताया गया है.
क्लाउड-टू-क्लाउड लिंकिंग	खाता लिंक करने के लिए क्लाउड-टू-क्लाउड	इसकी मदद से, खाता लिंक करने की प्रोसेस शुरू की जा सकती है. इससे क्लाउड से कनेक्ट किए गए डिवाइसों को Google Home के साथ शेयर किया जा सकता है. इसके लिए, आपको अपने ऐप्लिकेशन में जाना होगा. हमारा सुझाव है कि आप डीप लिंक की सुविधा का इस्तेमाल करें. इससे उपयोगकर्ताओं को परेशानी कम होगी. यह सुविधा Android और iOS, दोनों में उपलब्ध है. इससे उपयोगकर्ताओं को सीधे GHA में खाता लिंक करने वाले पेज पर ले जाया जाता है.
Android पर Commissioning API	Matter Commissioning	आम तौर पर, इस एपीआई को नए Matter डिवाइसों को चालू करने के लिए इस्तेमाल किया जाता है. हालांकि, इसका इस्तेमाल उन Matter डिवाइसों में Google फ़ैब्रिक जोड़ने के लिए भी किया जा सकता है जिन्हें पहले ही किसी दूसरे फ़ैब्रिक के साथ चालू किया जा चुका है. इसलिए, यह ऑनबोर्डिंग प्रोसेस के लिए एक उपयोगी टूल है.

तकनीकी तौर पर लागू करना

शेयर करने की प्रोसेस को बनाने का तरीका, इस बात पर निर्भर करता है कि आपको Google के साथ कौनसे डिवाइसों का डेटा शेयर करना है.

इन स्थितियों में, हमारा सुझाव है कि दिए गए क्रम में यह तरीका अपनाएं. इससे उपयोगकर्ताओं को बेहतर अनुभव देने में मदद मिलती है.

सिर्फ़ Matter वाले डिवाइस बनाए जाते हों

आपने Matter की सुविधा वाले ऐसे डिवाइस बनाए हैं जिन्हें Google Home में कमीशन करना है.

1. Android पर Permissions API को कॉल करें.

2. हर उस Matter डिवाइस पर Android पर उपलब्ध Commissioning API को कॉल करें जिसे पहले किसी दूसरे फ़ैब्रिक से कमीशन किया गया था.

   1. Matter हर डिवाइस के लिए अलग-अलग शेयरिंग करनी होती है. साथ ही, कई स्क्रीन पर उपयोगकर्ता से इनपुट की ज़रूरत होती है. इसलिए, हमारा सुझाव है कि आप उपयोगकर्ता को इस प्रोसेस के बारे में बताएं. इसके लिए, ये काम करें:
      • उपयोगकर्ताओं को उन Matter डिवाइसों की सूची देना जिन्हें Google के साथ शेयर नहीं किया जा रहा है.
      • इससे लोगों को डिवाइस शेयर करने की प्रोसेस शुरू करने की अनुमति मिलती है. इसके लिए, उन्हें सूची में मौजूद डिवाइसों पर क्लिक करना होगा. इस प्रोसेस में Commissioning API का इस्तेमाल किया जाता है.
      • Matter डिवाइसों की सूची पर वापस जाना. इसमें उपयोगकर्ता को टास्क की प्रोग्रेस और शेयर करने की स्थिति दिखती है.

सिर्फ़ उन डिवाइसों का डेटा शेयर किया जाता है जिन्हें Google के साथ Cloud-to-cloud API का इस्तेमाल करके शेयर किया गया है

1. Cloud-to-cloud डीप लिंकिंग की सुविधा का इस्तेमाल करें. इससे डिवाइस, Google Home Graph में जुड़ जाते हैं.

   1. हमारा सुझाव है कि आप सबसे पहले Cloud-to-cloudलिंक करने की प्रोसेस पूरी करें. इससे, संभावित भ्रम की स्थितियों से बचा जा सकता है. जैसे, उपयोगकर्ता को ऐसी सूची दिखाई जा सकती है जिसमें Google के साथ शेयर किए जा रहे डिवाइस और Google के साथ शेयर नहीं किए जा रहे डिवाइस शामिल हों.

2. Android पर Permissions API को कॉल करें.

आपके पास क्लाउड-टू-क्लाउड और Matter, दोनों तरह के डिवाइस बनाने की सुविधा हो

1. Cloud-to-cloud डीप लिंकिंग की सुविधा का इस्तेमाल करें.

   1. हमारा सुझाव है कि आप सबसे पहले Cloud-to-cloudलिंक करने की प्रोसेस पूरी करें. इससे, संभावित भ्रम की स्थितियों से बचा जा सकता है. जैसे, उपयोगकर्ता को ऐसी सूची दिखाई जा सकती है जिसमें Google के साथ शेयर किए जा रहे डिवाइस और Google के साथ शेयर नहीं किए जा रहे डिवाइस शामिल हों.

2. Android पर Permissions API को कॉल करें.

3. पहले किसी दूसरे फ़ैब्रिक से कनेक्ट किए गए हर Matter डिवाइस पर, Android के लिए Commissioning API को कॉल करें.

   1. Matter हर डिवाइस के लिए अलग-अलग शेयरिंग करनी होती है. साथ ही, कई स्क्रीन पर उपयोगकर्ता से इनपुट की ज़रूरत होती है. इसलिए, हमारा सुझाव है कि आप उपयोगकर्ता को इस प्रोसेस के बारे में बताएं. इसके लिए, ये काम करें:
      • उपयोगकर्ताओं को उन Matter डिवाइसों की सूची देना जिन्हें Google के साथ शेयर नहीं किया जा रहा है.
      • इससे लोगों को डिवाइस शेयर करने की प्रोसेस शुरू करने की अनुमति मिलती है. इसके लिए, उन्हें सूची में मौजूद डिवाइसों पर क्लिक करना होगा. इस प्रोसेस में Commissioning API का इस्तेमाल किया जाता है.
      • Matter डिवाइसों की सूची पर वापस जाना. इसमें उपयोगकर्ता को टास्क की प्रोग्रेस और शेयर करने की स्थिति दिखती है.

आपके पास Google के साथ शेयर करने के लिए कोई डिवाइस नहीं है

Permissions API को कॉल करें.

यूएक्स के सबसे सही तरीके

इस सेक्शन में, उपयोगकर्ता के कुछ अहम सफ़र के बारे में बताया गया है. Home API का इस्तेमाल करके ऐप्लिकेशन डेवलप करते समय, इन बातों का ध्यान रखें.

ऐप्लिकेशन में डिवाइस शेयर करने की सुविधा कहां जोड़ें

यह पूरी सूची नहीं है. आपको अपने उपयोगकर्ताओं को समय पर Google Home के बारे में बताने और उन्हें इसे शेयर करने का अनुभव देने के अन्य मौके भी मिल सकते हैं.

ये भी यूनीक नहीं हैं. इनके कई एंट्री पॉइंट हैं:

सेटिंग मेन्यू से

उपयोगकर्ता, सेटिंग मेन्यू के ज़रिए Google Home के इकोसिस्टम से कनेक्शन सेट अप करने के आदी होते हैं. इसलिए, इस तरीके से वे इस पैराडाइम का इस्तेमाल जारी रख सकते हैं.

डिवाइस शेयर करने (Cloud-to-cloud लिंक करना और Matter Commissioning API) को ऐप्लिकेशन की अनुमति देने (Permissions API) से अलग किया जा सकता है. इससे उपयोगकर्ताओं को यह तय करने का विकल्प मिलता है कि उन्हें कौनसे चरण पूरे करने हैं. साथ ही, आपको उपयोगकर्ता को कनेक्शन की स्थिति दिखाने का मौका मिलता है.

Google की मदद से चलाए जा रहे ऑटोमेशन में डिवाइसों का इस्तेमाल करते समय

'ऑटोमेशन' टैब में जाकर, उपयोगकर्ता शेयर करने के फ़्लो के एंट्री पॉइंट पर टैप कर सकते हैं. इसके बाद, वे वैल्यू प्रपोज़िशन स्क्रीन पढ़ सकते हैं. इसमें आगे बढ़ने के फ़ायदे के बारे में साफ़ तौर पर बताया गया है. इसके बाद, वे अनुमति देने के फ़्लो पर तुरंत जा सकते हैं.

सिर्फ़ कमीशनिंग से

यह स्थिति मुख्य रूप से उन पार्टनर के लिए है जो सिर्फ़ Matter डिवाइस बनाते हैं (Cloud-to-cloud डिवाइस नहीं) और जिनके पास अपना Matter फ़ैब्रिक नहीं है. उपयोगकर्ता के लिए एंट्री पॉइंट, बॉक्स से बाहर निकलने के तुरंत बाद दिखने वाली स्क्रीन पर हो सकता है. इस स्क्रीन पर, Matter डिवाइसों को शेयर करने (कमीशनिंग एपीआई के ज़रिए) और ऐप्लिकेशन की अनुमतियां देने (अनुमतियां एपीआई के ज़रिए) की सुविधा, उपयोगकर्ता अनुभव के एक ही फ़्लो का हिस्सा होती है.

शेयर करने का लॉजिक

उपयोगकर्ता के सवालों के बारे में कुछ सुझाव यहां दिए गए हैं:

• आम तौर पर, उपयोगकर्ताओं को सिर्फ़ उन चरणों को पूरा करने के लिए कहा जाना चाहिए जो प्लैटफ़ॉर्म पर शामिल होने के लिए ज़रूरी हैं. उदाहरण के लिए, लंबे समय से ओईएम के डिवाइस इस्तेमाल कर रहे ग्राहक, शायद पहले से ही Google के साथ ओईएम के डिवाइसों का डेटा शेयर कर रहे हों. ऐसे में, उन्हें सिर्फ़ Home API के लिए अनुमति देने की प्रोसेस पूरी करनी होगी, ताकि ऐप्लिकेशन को Google Home का ऐक्सेस मिल सके.

• ऐसा हो सकता है कि एक से ज़्यादा Google Home एडमिन, Google Home स्ट्रक्चर शेयर कर रहे हों. इसके अलावा, ऐसा भी हो सकता है कि Google के साथ डिवाइसों को शेयर करने के लिए, सिर्फ़ एक खाते का इस्तेमाल किया जा रहा हो. इसलिए, Cloud-to-cloud को लिंक करने की प्रोसेस पूरी करना, Home API की अनुमतियों के लिए प्रॉम्प्ट करने की ज़रूरी शर्त नहीं होनी चाहिए.

विज़ुअल डिज़ाइन से जुड़े सुझाव

• Google Home में शामिल होने का साफ़ तौर पर फ़ायदा बताया गया हो. उदाहरण के लिए, "Google Home की मदद से बेहतर ऑटोमेशन बनाएं" या "अपनी पसंद के ऐप्लिकेशन का इस्तेमाल करके डिवाइसों को कंट्रोल करें".

• कॉल-टू-ऐक्शन (उदाहरण के लिए, "शुरू करें") और अगर उपयोगकर्ता को जारी नहीं रखना है, तो रद्द करने का विकल्प.

• अगर जगह हो, तो इस बारे में जानकारी दें कि उपयोगकर्ता के स्क्रीन पर आगे बढ़ने पर क्या होगा.

• खास तौर पर Matter के लिए, अगर उपयोगकर्ता ने Home API के ज़रिए आपको पहले ही अपने होम को ऐक्सेस करने की अनुमति दी है, तो नए डिवाइसों को चालू करते समय, Google Home के साथ अपने होम में मौजूद डिवाइसों को शेयर किया जा सकता है. उदाहरण के लिए, अपने फ़ैब्रिक में कोई Matter डिवाइस जोड़ा जा सकता है. इसके बाद, उपयोगकर्ता को इस डिवाइस को Google फ़ैब्रिक में जोड़ने के लिए कहा जा सकता है.

कॉन्टेंट के सुझाव

उपयोगकर्ताओं को ऐसी चीज़ों पर भरोसा करना आसान होता है जिन्हें वे समझते हैं और जो उनके काम की होती हैं. उपयोगकर्ताओं को जानकारी देकर उन्हें बेहतर फ़ैसले लेने में मदद करें. इसमें ट्रेडऑफ़ भी शामिल हैं.

सबसे अहम पिच

अगर डिवाइस शेयर करने के लिए कोई खास वजह नहीं है, तो उपयोगकर्ता डिवाइस शेयर नहीं करेंगे.

• इस बात पर खास ध्यान दें कि आपने ऑफ़र को किस तरह से पेश किया है.
• इसे आकर्षक बनाएं, लेकिन ज़्यादा वादे न करें.
• अगर उपयोगकर्ता को आपकी पिच में बताए गए डिवाइस की ज़रूरत है, तो पक्का करें कि आपने इस बारे में साफ़ तौर पर बताया हो, ताकि उन्हें कोई समस्या न हो.
• आपके पास इन उपयोगकर्ताओं को ग्राहक में बदलने का सिर्फ़ एक मौका हो सकता है. इसलिए, इसका पूरा फ़ायदा उठाएं.

सबसे सही तरीके

1. उपयोगकर्ता के नज़रिए से शुरुआत करें. यानी, "इससे मुझे क्या फ़ायदा होगा?" के बारे में बताएं.
2. सेक्शन ब्लॉक में, चार से ज़्यादा लाइनों का कॉन्टेंट न लिखें. ज़्यादा शब्दों से उपयोगकर्ता का ध्यान भटक सकता है. हालांकि, कम शब्दों में जानकारी देने के बजाय, साफ़ तौर पर और आसानी से समझ में आने वाली जानकारी देना ज़्यादा अहम हो सकता है.
3. ऑटोमेशन की सुविधा बहुत मज़ेदार है! अगर जगह हो, तो कोई दिलचस्प और मददगार उदाहरण दें.
4. अगर यह आपकी रणनीति के मुताबिक है, तो मज़ेदार आवाज़ और टोन का इस्तेमाल करें.
5. कार्रवाई करने के लिए इस्तेमाल किए जाने वाले वाक्यांशों का इस्तेमाल करें. जैसे, "शुरू करें."