खाते को अनुमति देने से पहले, पक्का करें कि आपके पास:
- आपके Android फ़ोन या टैबलेट पर Google Home app (GHA) इंस्टॉल हो.
- होम में मौजूद, सैंपल ऐप्लिकेशन के लिए इनमें से कम से कम एक डिवाइस टाइप:
- कलर टेंपरेचर लाइट (चालू और बंद करना, ब्राइटनेस)
- संपर्क सेंसर (बूलियन स्थिति)
- डिम की जा सकने वाली लाइट (चालू और बंद करना, रोशनी कम या ज़्यादा करना)
- दरवाज़े का लॉक
- एक्सटेंडेड कलर लाइट (चालू और बंद करना, रोशनी)
- जेनेरिक स्विच
- Google बॉर्डर राऊटर
- Google Camera
- Google Doorbell
- होम में लोगों की मौजूदगी का पता लगाने वाला सेंसर (होम में लोगों की मौजूदगी का पता लगाने की सुविधा)
- लाइट चालू/बंद करना (चालू और बंद करना, रोशनी)
- लाइट चालू/बंद करने वाला स्विच
- चालू/बंद करने वाली प्लग-इन यूनिट (चालू और बंद)
- चालू/बंद करने वाला सेंसर
- ऑटोमेशन के सैंपल की जांच करने के लिए दो डिवाइस.
Home API के ज़रिए डिवाइसों का इस्तेमाल करने से पहले, यह ज़रूरी है कि उन्हें GHA से कंट्रोल किया जा सके.
Android के लिए सैंपल ऐप्लिकेशन चलाना
किसी खाते को अनुमति देने से पहले, पुष्टि करें कि सैंपल के तौर पर मिले ऐप्लिकेशन को आपके प्रोजेक्ट के लिए सही OAuth स्कोप के साथ कॉन्फ़िगर किया गया है. सैंपल के तौर पर मिले ऐप्लिकेशन का सोर्स कोड, डिफ़ॉल्ट रूप से https://www.googleapis.com/auth/home.platform.v2 स्कोप का इस्तेमाल करता है. सैंपल के तौर पर मिले ऐप्लिकेशन में मौजूद कई सुविधाएं, home.platform.v2 स्कोप से जुड़ी हैं. इन्हें ऐक्सेस करने के लिए, पार्टनर की अनुमति ज़रूरी है. स्टैंडर्ड https://www.googleapis.com/auth/home.platform.selected.devices स्कोप के साथ सैंपल के तौर पर मिले ऐप्लिकेशन को अनुमति देने और उसका इस्तेमाल करने के लिए, HomeModule.kt में जाकर homePlatformScope को HOME_PLATFORM_SCOPE_VERSION_1 पर मैन्युअल तरीके से स्विच करें. इसके बारे में ऐप्लिकेशन बनाना लेख में बताया गया है.
Android के लिए सैंपल ऐप्लिकेशन चलाएं. इसे पहली बार चलाने पर, आपसे Google खाते में मौजूद होम को ऐक्सेस करने की अनुमति मांगी जाएगी. इससे Sample App को उस होम में मौजूद डिवाइसों और स्ट्रक्चर को ऐक्सेस करने और कंट्रोल करने की अनुमति मिलती है.
अगर आपके पास कोई स्ट्रक्चर नहीं है, तो उपयोगकर्ता अनुमति देने की प्रोसेस के दौरान स्ट्रक्चर बना सकता है. इसके लिए, उसे GHA का इस्तेमाल करने की ज़रूरत नहीं है.
ऐप्लिकेशन के लिए अनुमति देने या न देने का डिफ़ॉल्ट तरीका, इस बात पर निर्भर करेगा कि ऐप्लिकेशन Google Home Developer Console पर रजिस्टर किया गया था या नहीं.
अगर कोई ऐप्लिकेशन Developer Console में रजिस्टर नहीं है, तो वह 'पुष्टि नहीं हुई' स्थिति में होगा. होम एपीआई के इस्तेमाल की जांच करने के लिए, यह तरीका अपनाने का सुझाव दिया जाता है:
सिर्फ़ वे उपयोगकर्ता ऐप्लिकेशन को अनुमतियां दे सकते हैं जो OAuth कंसोल में टेस्ट उपयोगकर्ता के तौर पर रजिस्टर हैं. बिना पुष्टि वाले ऐप्लिकेशन के लिए, ज़्यादा से ज़्यादा 100 टेस्ट उपयोगकर्ता हो सकते हैं.
पुष्टि न किए गए ऐप्लिकेशन के पास, उन सभी डिवाइस टाइप के डिवाइसों का ऐक्सेस होगा जो Home API के लिए OAuth के साथ काम करते हैं. डिवाइस टाइप की सूची Developer Console में दी गई है. किसी स्ट्रक्चर में मौजूद सभी डिवाइसों को अनुमति दी जाएगी.
अगर कोई ऐप्लिकेशन Developer Console में रजिस्टर किया गया है और उसे एक या उससे ज़्यादा तरह के डिवाइसों को ऐक्सेस करने की अनुमति मिल गई है, तो वह पुष्टि की गई स्थिति में होगा. इसके लिए, OAuth के लिए ब्रैंड की पुष्टि की प्रक्रिया पूरी होनी चाहिए. किसी ऐप्लिकेशन को प्रोडक्शन में लॉन्च करने के लिए, यह स्थिति ज़रूरी है:
- टेस्ट यूज़र की सीमाएं अब लागू नहीं होंगी. कोई भी उपयोगकर्ता, ऐप्लिकेशन को अनुमति दे सकता है.
- उपयोगकर्ता सिर्फ़ उन डिवाइस टाइप को अनुमति दे सकता है जिन्हें Developer Console में मंज़ूरी मिली थी.
चुने गए होम का ऐक्सेस दें पर टैप करें:
- अगर आपके खाते से कोई होम कनेक्ट है, तो अनुमति देने के लिए कोई होम चुनें. अगर चुने गए होम में कोई डिवाइस नहीं मिलता है, तो इनमें से कोई एक काम करें:
- कोई दूसरा होम चुनने के लिए, किसी दूसरे होम का ऐक्सेस दें पर टैप करें.
- Google Home app (GHA) का इस्तेमाल करके, उस होम में अपनी पसंद का कोई डिवाइस सेट अप करें. याद रखें कि सैंपल के तौर पर मिले इस ऐप्लिकेशन में, सिर्फ़ इन डिवाइस टाइप को कंट्रोल करने की सुविधा उपलब्ध है:
- कलर टेंपरेचर लाइट (चालू और बंद करना, ब्राइटनेस)
- संपर्क सेंसर (बूलियन स्थिति)
- डिम की जा सकने वाली लाइट (चालू और बंद करना, रोशनी कम या ज़्यादा करना)
- दरवाज़े का लॉक
- एक्सटेंडेड कलर लाइट (चालू और बंद करना, रोशनी)
- जेनेरिक स्विच
- Google बॉर्डर राऊटर
- Google Camera
- Google Doorbell
- होम में लोगों की मौजूदगी का पता लगाने वाला सेंसर (होम में लोगों की मौजूदगी का पता लगाने की सुविधा)
- लाइट चालू/बंद करना (चालू और बंद करना, रोशनी)
- लाइट चालू/बंद करने वाला स्विच
- चालू/बंद करने वाली प्लग-इन यूनिट (चालू और बंद)
- चालू/बंद करने वाला सेंसर
- अगर आपके खाते से कोई होम कनेक्ट नहीं है, तो आपको एक स्क्रीन दिखेगी. इस पर यह मैसेज होगा: चुने गए खाते से कोई स्ट्रक्चर कनेक्ट नहीं है.
- मुख्य सैंपल ऐप्लिकेशन व्यू पर वापस जाने के लिए, पीछे की ओर स्वाइप करें.
- होम सेट अप करने के लिए, GHA का इस्तेमाल करें. इसके बाद, सैंपल के तौर पर मिले ऐप्लिकेशन को फिर से अनुमति देने की कोशिश करें.
अनुमतियों के फ़्लो को किसी भी समय फिर से देखा जा सकता है. इसके लिए, सैंपल के तौर पर मिले ऐप्लिकेशन की किसी भी स्क्रीन पर सबसे ऊपर दाईं ओर मौजूद, प्रोफ़ाइल का आइकॉन चुनें.
डिवाइसों वाले होम को अनुमति देने के बाद, आपको डिवाइसों के व्यू पर ले जाया जाएगा. सैंपल के तौर पर मिले ऐप्लिकेशन की मदद से, डिवाइसों को कंट्रोल किया जा सकता है और उनकी स्थिति में होने वाले बदलावों को देखा जा सकता है.