किसी Android ऐप्लिकेशन में Home API जोड़ने के लिए, आपको कुछ ज़रूरी शर्तें पूरी करनी होंगी.
ज़रूरी शर्तें
डेवलपमेंट के लिए, आपको एक ऐसे कंप्यूटर की ज़रूरत होगी जिसमें ये टूल इंस्टॉल हों:
Android Studio, वर्शन 2024.2.1 ("Ladybug") या इसके बाद का वर्शन. ध्यान दें कि इससे पहले के वर्शन, Home APIs SDK के साथ ठीक से काम नहीं करेंगे.
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)
- चालू/बंद करने वाला सेंसर
इस्तेमाल किए जा सकने वाले हब
Home API सिर्फ़ कुछ Google Nest Hub डिवाइसों पर काम करते हैं.
एसडीके टूल सेट अप करना
इस ओपन बीटा वर्शन में उपलब्ध Home API, फ़िलहाल Google की उन स्टैंडर्ड लाइब्रेरी का हिस्सा नहीं हैं जो डेवलपमेंट के लिए उपलब्ध कराई जाती हैं. Home API का इस्तेमाल करके ऐप्लिकेशन डेवलप करने के लिए, आपको लाइब्रेरी डाउनलोड करनी होंगी और उन्हें स्थानीय तौर पर होस्ट करना होगा.
Home API के Android SDK को डाउनलोड करने के लिए, आपको पहले Google Home Developers में साइन इन करना होगा.