Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Home APIs Android Sample App

सैंपल के तौर पर मिला ऐप्लिकेशन, Android के लिए Google Home API की बुनियादी सुविधाओं को दिखाता है.

ज़रूरी शर्तें

ऐप्लिकेशन बनाने, इंस्टॉल करने, और टेस्ट करने के लिए, आपको कुछ ज़रूरी शर्तें पूरी करनी होंगी:

Android Studio, वर्शन 2024.2.1 ("Ladybug") या इसके बाद का वर्शन. ध्यान दें कि इससे पहले के वर्शन, Home APIs SDK के साथ ठीक से काम नहीं करेंगे.

Android Studio डाउनलोड करना
Android डीबगर (adb).

adb इंस्टॉल करें.

यह काम एसडीके मैनेजर की मदद से किया जा सकता है.

Home API को टेस्ट करने के लिए, आपको इनकी ज़रूरत होगी:

Android 10 या इसके बाद के वर्शन वाला Android डिवाइस, जिसमें उस Google खाते से सेट अप किया गया हो जिसका इस्तेमाल आपको डेवलपमेंट के लिए करना है. पक्का करें कि Android Studio का अप-टू-डेट वर्शन इंस्टॉल हो और इस डेवलपर खाते से साइन इन किया गया हो.
वाई-फ़ाई नेटवर्क.
Matter डिवाइसों को ऐक्सेस और कंट्रोल करने के लिए, आपके पास Home API के साथ काम करने वाला Google हब भी होना चाहिए. ज़्यादा जानकारी के लिए, Android पर कनेक्टिविटी लेख पढ़ें.
होम में, इस सुविधा के साथ काम करने वाला कम से कम एक डिवाइस होना चाहिए. अगर यह डिवाइस (या कोई अन्य डिवाइस जिसकी आपको जांच करनी है) Thread का इस्तेमाल करता है, तो हब भी Thread Border Router (TBR) होना चाहिए. Android सैंपल के तौर पर मिला ऐप्लिकेशन में, यहां दिए गए डिवाइस टाइप और Traits इस्तेमाल किए जा सकते हैं:
- कलर टेंपरेचर लाइट (चालू और बंद करना, ब्राइटनेस)
- कॉन्टैक्ट सेंसर (बूलियन स्टेट)
- डिम की जा सकने वाली लाइट (चालू और बंद करना, चमक)
- दरवाज़े का लॉक
- एक्सटेंडेड कलर लाइट (चालू और बंद करना, रोशनी)
- जेनेरिक स्विच
- Google बॉर्डर राऊटर
- Google Camera
- Google Doorbell
- होम में लोगों की मौजूदगी का पता लगाने वाला सेंसर (होम में लोगों की मौजूदगी का पता लगाने की सुविधा)
- लाइट चालू/बंद करना (चालू और बंद करना, रोशनी)
- लाइट चालू/बंद करने का स्विच
- On/Off Plug-in Unit (on and off)
- चालू/बंद करने वाला सेंसर

सोर्स कोड डाउनलोड करना

सैंपल के तौर पर मिले ऐप्लिकेशन का सोर्स कोड GitHub पर उपलब्ध है.

उस जगह पर जाएं जहां आपको प्रोजेक्ट सेव करना है. इसके बाद, उसे क्लोन करें:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

एसडीके टूल सेट अप करना

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

Home API के Android SDK को डाउनलोड करने के लिए, आपको पहले Google Home Developers में साइन इन करना होगा.

अभी साइन इन करें!

ऐप्लिकेशन बनाना

Android Studio खोलें. इसके बाद, google-home-api-sample-app-android प्रोजेक्ट फ़ोल्डर खोलें, जिसे आपकी लोकल मशीन में क्लोन किया गया था.
पहली बार सेटअप करने के दौरान, Android Studio को प्रोजेक्ट की सभी डिपेंडेंसी डाउनलोड करने और Gradle बिल्ड को पूरा करने में 10 मिनट लग सकते हैं.

अहम जानकारी: अगर आपको इस चरण के दौरान कोई गड़बड़ी मिलती है, जैसे कि Gradle Sync Failed, तो सिंक करने की प्रोसेस को फिर से शुरू करने के लिए, फिर से कोशिश करें पर क्लिक करें.
अपने कंप्यूटर को यूएसबी केबल की मदद से किसी Android फ़ोन से कनेक्ट करें और डेवलपर के लिए सेटिंग और टूल में जाकर, एडीबी को चालू करें. पक्का करें कि Android Studio, एडीबी के ज़रिए Android फ़ोन से कनेक्ट हो सके.

ध्यान दें: हमारा सुझाव है कि आप सैंपल ऐप्लिकेशन को Android एम्युलेटर के बजाय, किसी असली Android फ़ोन पर चलाएं. ऐसा इसलिए, क्योंकि Home API, असली फ़ोन पर चल रही Google Play services पर निर्भर करते हैं.
सैंपल के तौर पर मिले ऐप्लिकेशन के पैकेज का नाम बदलकर कोई ऐसा नया नाम रखें जो पहले से रजिस्टर न किया गया हो. जैसे, आपके संगठन के नाम पर आधारित कोई नाम:
1. प्रोजेक्ट खोलें.
2. सोर्स की हैरारकी को बड़ा करें.
3. पैकेज का वह हिस्सा चुनें जिसमें आपको बदलाव करना है. दूसरे शब्दों में, com.example.
4. पैकेज पर राइट क्लिक करें और Refactor > Rename... को चुनें
5. नया नाम डालें और Refactor पर क्लिक करें.
6. build.gradle.kts फ़ाइल में बदलाव करें. इसके लिए, android namespace और applicationId को नए पैकेज के नाम से बदलें.
HomeModule.kt में OAuth का दायरा कॉन्फ़िगर करें. डिफ़ॉल्ट रूप से, सैंपल के तौर पर मिले ऐप्लिकेशन का सोर्स कोड, https://www.googleapis.com/auth/home.platform.v2 स्कोप का इस्तेमाल करता है. सैंपल के तौर पर मिले ऐप्लिकेशन की कई सुविधाएं, home.platform.v2 स्कोप से जुड़ी होती हैं. इन्हें ऐक्सेस करने के लिए, पार्टनर की अनुमति ज़रूरी होती है. सैंपल के तौर पर मिले ऐप्लिकेशन को स्टैंडर्ड https://www.googleapis.com/auth/home.platform.selected.devices स्कोप के साथ चलाने के लिए, HomeModule.kt खोलें और HomeConfig में homePlatformScope को बदलकर HOME_PLATFORM_SCOPE_VERSION_1 करें:
```
val homeConfig = HomeConfig(
  coroutineContext = Dispatchers.IO,
  factoryRegistryProvider = {
    FactoryConstants.factoryRegistryAllTraitsAllTypes
  },
  homePlatformScope =
    HomeConfig.HomePlatformScope.HOME_PLATFORM_SCOPE_VERSION_1
)
```

HomeClientProvider.kt में switchAccount() में homePlatformScope को HOME_PLATFORM_SCOPE_VERSION_1 में भी अपडेट करें. अगर ऐसा नहीं है, तो खाते बदलने के लिए प्रोफ़ाइल आइकॉन को चुनने पर, ऐप्लिकेशन HOME_PLATFORM_SCOPE_VERSION_2 पर वापस चला जाता है.

सभी ज़रूरी लाइब्रेरी डाउनलोड होने और Gradle सिंक होने के बाद, ऐप्लिकेशन को बनाने और चलाने के लिए, Run बटन पर क्लिक करें. जब ऐप्लिकेशन आपके फ़ोन पर सही तरीके से चलने लगेगा, तब आपको सैंपल के तौर पर मिला ऐप्लिकेशन का मुख्य पेज दिखेगा.

साइनिंग सर्टिफ़िकेट बनाना

Android Studio में किसी ऐप्लिकेशन को चलाने या डीबग करने पर, यह अपने-आप एक डीबग सर्टिफ़िकेट जनरेट करता है. इसका इस्तेमाल, ऐप्लिकेशन को डेवलप और डीबग करने के लिए किया जाता है. पूरी जानकारी के लिए, Android Studio: डीबग के लिए बिल्ड पर हस्ताक्षर करना देखें.

Android Studio में ऐप्लिकेशन को चलाकर, डीबग ऐप्लिकेशन साइनिंग सर्टिफ़िकेट जनरेट करें. Android Studio में किसी ऐप्लिकेशन को चलाने या डीबग करने पर, Android Studio अपने-आप ऐप्लिकेशन साइनिंग सर्टिफ़िकेट जनरेट करता है. इसका मकसद, ऐप्लिकेशन को डेवलप और डीबग करना होता है. पूरी जानकारी के लिए, Android Studio: डीबग के लिए बिल्ड पर हस्ताक्षर करना देखें.

अपने फ़ोन या टैबलेट को अपनी लोकल मशीन से कनेक्ट करें. Android Studio, कनेक्ट किए गए डिवाइसों को मॉडल नंबर के हिसाब से दिखाएगा. सूची में से अपना डिवाइस चुनें. इसके बाद, प्रोजेक्ट चलाएं पर क्लिक करें. इससे आपके मोबाइल डिवाइस पर, सैंपल के तौर पर मिला ऐप्लिकेशन बनता और इंस्टॉल होता है.

ज़्यादा जानकारी के लिए, Android Developers साइट पर जाकर, हार्डवेयर डिवाइस पर ऐप्लिकेशन चलाना लेख पढ़ें.

अब चल रहे ऐप्लिकेशन को बंद करें.
अपने डीबग सर्टिफ़िकेट का SHA-1 फ़िंगरप्रिंट पाने के लिए, Google Cloud Console के सहायता केंद्र की साइट पर दिए गए निर्देशों का पालन करें. ये निर्देश, OAuth क्लाइंट / ऐप्लिकेशन के टाइप / नेटिव ऐप्लिकेशन / Android मैनेज करें पेज पर दिए गए हैं.
सलाह: Android Studio 2024.2.1 ('Ladybug') या इसके बाद के वर्शन में, अपने प्रोजेक्ट के कीस्टोर की जगह का पता लगाने के लिए:
1. Settings > Experimental में जाकर, पक्का करें कि Configure all Gradle tasks during Gradle Sync को चुना गया हो.
2. Gradle टूल विंडो खोलें.
3. अपना प्रोजेक्ट चुनें.
4. ऐप्लिकेशन से शुरू करके, Gradle सेटिंग ट्री को बड़ा करें ( ऐप्लिकेशन > टास्क > android ).
5. android में जाकर, signingReport को चुनें.
6. साइनिंग रिपोर्ट, सबसे नीचे मौजूद पैनल में दिखती है. Store से शुरू होने वाली लाइन देखें. इससे आपको debug.keystore फ़ाइल की जगह की जानकारी मिलती है.

OAuth के लिए सहमति देने की सुविधा सेट अप करना

Google Cloud Console में, प्रोजेक्ट चुनने वाले डैशबोर्ड पर जाएं. इसके बाद, वह प्रोजेक्ट चुनें जिसका इस्तेमाल करके आपको OAuth क्रेडेंशियल बनाने हैं.
एपीआई और सेवाएं पेज पर जाएं. इसके बाद, नेविगेशन मेन्यू में क्रेडेंशियल पर क्लिक करें.
अगर आपने इस Google Cloud प्रोजेक्ट के लिए, सहमति वाली स्क्रीन को अब तक कॉन्फ़िगर नहीं किया है, तो आपको सहमति वाली स्क्रीन को कॉन्फ़िगर करें बटन दिखेगा. ऐसे में, इस तरीके का इस्तेमाल करके, सहमति वाली स्क्रीन को कॉन्फ़िगर करें. अगर ऐसा नहीं है, तो अगले सेक्शन पर जाएं.
1. ऐसी स्क्रीन जहां OAuth के लिए सहमति दी जाती है कॉन्फ़िगर करें पर क्लिक करें. OAuth के लिए सहमति देने वाली स्क्रीन पेज दिखता है.
2. अपने इस्तेमाल के उदाहरण के आधार पर, इंटरनल या एक्सटर्नल चुनें. इसके बाद, बनाएं पर क्लिक करें. OAuth के लिए सहमति वाली स्क्रीन का पैनल दिखता है.
3. स्क्रीन पर दिए गए निर्देशों के मुताबिक, ऐप्लिकेशन की जानकारी वाले पेज पर जानकारी डालें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें. इसके बाद, आपको स्कोप पैनल दिखेगा.
4. आपको कोई स्कोप जोड़ने की ज़रूरत नहीं है. इसलिए, सेव करें और जारी रखें पर क्लिक करें. टेस्ट यूज़र पैनल दिखता है.
5. ऑडियंस पर क्लिक करें. इसके बाद, + उपयोगकर्ता जोड़ें बटन पर क्लिक करें.
6. टेस्ट उपयोगकर्ता का ईमेल पता डालें और सेव करें बटन पर क्लिक करें.
7. सेव करें और जारी रखें पर क्लिक करें. आपको खास जानकारी पैनल दिखेगा.
8. OAuth के लिए सहमति वाली स्क्रीन पर मौजूद जानकारी की समीक्षा करें. इसके बाद, डैशबोर्ड पर वापस जाएं पर क्लिक करें.

पूरी जानकारी के लिए, Google Cloud Console की सहायता साइट पर OAuth के लिए सहमति देने की स्क्रीन सेट अप करना लेख पढ़ें. जारी रखने से पहले, कम से कम एक टेस्ट उपयोगकर्ता को जोड़ना न भूलें.

OAuth क्रेडेंशियल सेट अप करना

OAuth 2.0 के लिए, सैंपल के तौर पर मिले ऐप्लिकेशन को रजिस्टर करें और OAuth क्रेडेंशियल बनाएं. इसके लिए, OAuth 2.0 सेट अप करना लेख में दिए गए निर्देशों का पालन करें.
1. ऐप्लिकेशन का टाइप बताएं, जो नेटिव/Android ऐप्लिकेशन है.
2. OAuth क्लाइंट में SHA-1 फ़िंगरप्रिंट जोड़ें. इसके लिए, Google Cloud Console के सहायता केंद्र की साइट पर, OAuth 2.0 / नेटिव ऐप्लिकेशन / Android सेट अप करना में दिए गए निर्देशों का पालन करें. डेवलपमेंट की पूरी प्रोसेस के दौरान, आपको डिफ़ॉल्ट Android Studio कुंजी से SHA-1 कुंजी जनरेट करनी चाहिए.

ऐप्लिकेशन चलाना

अपने मोबाइल डिवाइस को लोकल मशीन से कनेक्ट करें. इसके बाद, अपने मोबाइल डिवाइस पर सैंपल ऐप्लिकेशन चलाने के लिए, प्रोजेक्ट चलाएं पर फिर से क्लिक करें.

इंस्टॉल होने के बाद, यह ऐप्लिकेशन आपके मोबाइल डिवाइस पर Home API Sample App के तौर पर उपलब्ध हो जाता है.