Google Home Sample App for Matter, Google Home Mobile SDK का इस्तेमाल करके, Google Home app (GHA) जैसा Android ऐप्लिकेशन बनाता है. सैंपल के तौर पर मिले इस ऐप्लिकेशन में ये सुविधाएं मिलती हैं:
- लोकल Android फ़ैब्रिक में, फ़िज़िकल और वर्चुअल Matter डिवाइसों को कमीशन करें
- डेवलपमेंट फ़ैब्रिक में फ़िज़िकल और वर्चुअल डिवाइसों को कमीशन करना
- अपने डेवलपमेंट फ़ैब्रिक पर डिवाइसों को कंट्रोल करना. जैसे, लाइट चालू करना
- मल्टी-एडमिन सुविधाओं की मदद से, डेवलपमेंट फ़ैब्रिक पर मौजूद डिवाइसों को अन्य ऐप्लिकेशन के साथ शेयर किया जा सकता है. साथ ही, अन्य ऐप्लिकेशन से शेयर किए गए डिवाइसों को डेवलपमेंट फ़ैब्रिक में शामिल किया जा सकता है
- डेवलपर यूटिलिटी
इस गाइड में, Sample App for Matter APK को इंस्टॉल करने का तरीका बताया गया है. साथ ही, Matter डिवाइसों को कमीशन करने, कंट्रोल करने, और शेयर करने के लिए, इसका इस्तेमाल करने का तरीका बताया गया है.
सोर्स कोड डाउनलोड करने, Mobile SDK को इंटिग्रेट करने का तरीका जानने, और Android Studio में स्क्रीन को पसंद के मुताबिक बनाने के लिए, हमारा Sample App for Matter कोडलैब आज़माएं.
Sample App for Matter कोडलैब पर जाएं
ज़रूरी शर्तें
- टेस्टिंग के लिए, Android O (8.1, एपीआई लेवल 27) या इसके बाद के वर्शन वाला डिवाइस उपलब्ध हो. यह पक्का करने के लिए कि आपके डिवाइस में Matter का नया वर्शन है, Matter के मॉड्यूल और सेवाओं की पुष्टि करें गाइड देखें.
- चालू/बंद करने की सुविधाओं वाला Matter डिवाइस बनाएं. सैंपल के तौर पर मिला यह ऐप्लिकेशन, वर्चुअल डिवाइस और ESP32 के साथ काम करता है.
- Matter Virtual Device (MVD). एनवायरमेंट से जुड़ी समस्याओं को कम करने के लिए, हमारा सुझाव है कि शुरुआत में MVD का इस्तेमाल करें. अगर आपको कभी कोई समस्या आती है, तो सैंपल के तौर पर मिले ऐप्लिकेशन को MVD के साथ इस्तेमाल करने पर, समस्या की जांच करना ज़्यादा आसान हो जाएगा.
rootnode_dimmablelight_bCwGYSDpoeऐप्लिकेशन की मदद से, Matter वर्चुअल डिवाइस बनाएं. Google Home Developer Console में Matter इंटिग्रेशन बनाने के लिए, वेंडर आईडी के तौर पर0xFFF1और प्रॉडक्ट आईडी के तौर पर0x8000का इस्तेमाल करें.all-clusters-appकी मदद से, Espressif डिवाइस बनाएं. Developer Console में Matter इंटिग्रेशन बनाने के दौरान, वेंडर आईडी के तौर पर0xFFF1और प्रॉडक्ट आईडी के तौर पर0x8001का इस्तेमाल करें.
Sample App for Matter की मदद से डिवाइसों को चालू और कंट्रोल करने के लिए, आपको Google Nest Hub (2nd gen) जैसे किसी हब की ज़रूरत नहीं है.
इंस्टॉल करें
Sample App for Matter GitHub रिपॉज़िटरी में Releases सेक्शन पर जाएं. सबसे हाल ही की रिलीज़ के लिए, ऐसेट सेक्शन में
GHSAFM-version-default-debug.apkनाम का APK ढूंढें.targetcommissionerको न चुनें.Android डीबग ब्रिज (adb) इंस्टॉल करें:
अपने Android डिवाइस को यूएसबी से कनेक्ट करें और फ़ाइल ट्रांसफ़र की सुविधा चालू करें. इसके बाद, APK इंस्टॉल करें:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
डिवाइसों को कमीशन करना
सैंपल के तौर पर मिले ऐप्लिकेशन को पहली बार लॉन्च करने पर, आपको एक डायलॉग बॉक्स दिखेगा. इसमें Sample App for Matter कोडलैब का लिंक होगा. अगर आपने यह मैसेज फिर से न दिखाएं को चुना है, तो ऐप्लिकेशन के एडमिन सेक्शन में जाकर अपनी प्राथमिकताएं अपडेट करके, डायलॉग बॉक्स को कभी भी वापस लाया जा सकता है.
अगले चरणों में, आपको लोकल Android फ़ैब्रिक में Matter डिवाइस जोड़ना होगा. साथ ही, आपको डेवलपमेंट फ़ैब्रिक भी जोड़ना होगा. यह फ़ैब्रिक, सिर्फ़ सैंपल के तौर पर मिले ऐप्लिकेशन के लिए लोकल होता है.
Matter फ़ैब्रिक क्या हैं?
Matter फ़ैब्रिक, होम नेटवर्क में मौजूद डिवाइसों के बीच शेयर किया गया एक भरोसेमंद डोमेन होता है. इसकी मदद से, डिवाइस एक-दूसरे से कनेक्ट हो पाते हैं.
डिवाइसों में एक या उससे ज़्यादा फ़ैब्रिक हो सकते हैं. ये फ़ैब्रिक किसी प्लैटफ़ॉर्म, ऐप्लिकेशन या एक साथ इंटरैक्ट करने वाले डिवाइसों के ग्रुप से जुड़े होते हैं. फ़ैब्रिक का एक यूनीक आईडी होता है. साथ ही, डिवाइसों के पास क्रेडेंशियल और सर्टिफ़िकेट देने वाली संस्था (सीए) का एक ही सेट होता है. ये क्रेडेंशियल, Matter को चालू करने के दौरान असाइन किए जाते हैं.
Matter डिवाइस को चालू करने के लिए, यह तरीका अपनाएं:
कमीशनिंग की प्रोसेस शुरू करने के लिए, डिवाइस जोड़ें बटन पर टैप करें.
इसके बाद, कंट्रोल Google Play services को ट्रांसफ़र किया जाता है. इसे Mobile SDK को कॉल करके लॉन्च किया जाता है. यह साबित करने के लिए कि आपके पास डिवाइस का ऐक्सेस है, क्यूआर कोड स्कैन करें या जोड़ने के लिए कोड इस्तेमाल करें पर टैप करें.
कमीशनिंग की प्रोसेस पूरी होने के बाद, डिवाइस का नाम डालें. इसके बाद, हो गया पर टैप करें.
आपका डिवाइस अब लोकल Android फ़ैब्रिक और डेवलपमेंट फ़ैब्रिक, दोनों से कनेक्ट हो गया है.
डिवाइसों को चालू करने के दौरान, चालू करने से जुड़े सभी काम और उनसे जुड़ी स्क्रीन को Play services मैनेज करता है. इससे उपयोगकर्ताओं को एक जैसा अनुभव मिलता है. साथ ही, संवेदनशील जानकारी ऐक्सेस करने की अनुमतियों को मैनेज करने की ज़रूरत नहीं पड़ती. उदाहरण के लिए, वाई-फ़ाई और Thread के क्रेडेंशियल.
डिवाइसों को कंट्रोल करना
डेवलपमेंट फ़ैब्रिक, सैंपल के तौर पर मिले ऐप्लिकेशन से Matter डिवाइसों को कंट्रोल करने के लिए क्रेडेंशियल बनाता है.
होम स्क्रीन से, अपने डिवाइस को चालू या बंद किया जा सकता है. डिवाइस की जानकारी ऐक्सेस करने के लिए, डिवाइस पर टैप करें.
डिवाइस शेयर करें
Matter की खास बातों में, डिवाइस को शेयर करने की सुविधा को मल्टी-एडमिन फ़्लो कहा जाता है. सैंपल के तौर पर मिले ऐप्लिकेशन में किसी डिवाइस को कमीशन करने के बाद, उसे अन्य नेटवर्क के साथ आसानी से शेयर किया जा सकता है.
अपने Matter डिवाइस को अन्य नेटवर्क के साथ शेयर करने के लिए, आपको अपने Android डिवाइस पर कोई दूसरा प्लैटफ़ॉर्म इंस्टॉल करना होगा. यह बाहरी प्लैटफ़ॉर्म, टारगेट कमिश्नर बन जाता है. हमने सैंपल के तौर पर मिले ऐप्लिकेशन का एक और इंस्टेंस बनाया है. इसका इस्तेमाल, टारगेट कमिश्नर के तौर पर किया जा सकता है.
Sample App for Matter GitHub रिपॉज़िटरी में Releases सेक्शन पर जाएं. सबसे हाल ही की रिलीज़ के लिए, ऐसेट सेक्शन में
GHSAFM-version-targetcommissioner-debug.apkनाम का APK ढूंढें.defaultको न चुनें.टारगेट कमिश्नर इंस्टॉल करें.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkहोम स्क्रीन पर, डिवाइस की जानकारी देखने के लिए डिवाइस पर टैप करें. शेयर करें पर टैप करें.
सैंपल के तौर पर मिला ऐप्लिकेशन, Mobile SDK के शेयर एपीआई को कॉल करता है. इसके बाद, कंट्रोल फिर से Play services को ट्रांसफ़र हो जाता है.
इसके बाद, आपको शेयर शीट दिखेगी. इसमें वह ऐप्लिकेशन या प्लैटफ़ॉर्म चुनें जिससे आपको डिवाइस को जोड़ना है. इस स्क्रीन पर, डिवाइस को शेयर करने के दो तरीके दिए गए हैं:
- सेटअप कोड का इस्तेमाल करके मैन्युअल तरीके से. यह कोड, टारगेट किए गए कमिश्नर ऐप्लिकेशन के साथ शेयर किया जाना चाहिए
- किसी ऐसे स्थानीय Android ऐप्लिकेशन के साथ जो Matter कमिश्नर के तौर पर रजिस्टर हो
टारगेट कमिश्नर ऐप्लिकेशन को GHSAFM-TC के तौर पर लेबल किया गया है. अपने डिवाइस को शेयर करने के लिए, सैंपल के तौर पर मिले ऐप्लिकेशन के इस इंस्टेंस पर टैप करें.
इसके बाद, बाहरी ऐप्लिकेशन (टारगेट कमिश्नर), डिवाइस को अपने फ़ैब्रिक में कमीशन करने की प्रोसेस पूरी करता है.
सेटिंग
होम स्क्रीन पर, सेटिंग आइकॉन पर क्लिक करें. यहां आपको उपयोगकर्ता की प्राथमिकताएं अपडेट करने, मदद पाने, और ऐप्लिकेशन के बारे में ज़्यादा जानने के विकल्प मिलते हैं.
हाफ़शीट सूचना
सेटिंग स्क्रीन पर जाकर, Matter डिवाइसों के लिए, कमीशन पाने की ज़रूरी शर्तें पूरी करने वाले डिवाइसों की खोज से जुड़ी सूचनाएं पाने की सुविधा को बंद किया जा सकता है.
अगर आपका ऐप्लिकेशन, Matter को खोजने या उसे चालू करने की सुविधा खुद उपलब्ध कराता है, तो हो सकता है कि आप इन सूचनाओं को रोकना चाहें, ताकि रुकावटों से बचा जा सके. ज़्यादा जानकारी के लिए, कमीशन पाने की ज़रूरी शर्तें पूरी करने वाले प्रॉडक्ट के बारे में बताने वाली सूचनाओं को रोकना लेख पढ़ें.
डेवलपर के लिए सुविधाएं
सेटिंग स्क्रीन से, डेवलपर यूटिलिटी को भी ऐक्सेस किया जा सकता है.
Logcat में, डिवाइस और उपयोगकर्ता की प्राथमिकताओं के डेटास्टोर रिपॉज़िटरी का कॉन्टेंट देखने के लिए, यह तरीका अपनाएं:
लॉग रिपॉज़िटरी का कॉन्टेंट पर क्लिक करें.
डायलॉग बॉक्स में ठीक है पर क्लिक करें. इसके बाद, Logcat देखें.
सुझाव/राय देना या शिकायत करना और मदद पाना
Sample App for Matter के साथ ऐप्लिकेशन डेवलप करने के अनुभव को बेहतर बनाने के लिए, अपने सुझाव या राय सबमिट करें. इसके लिए, सुझाव, राय देने या शिकायत करने के लिए उपलब्ध फ़ॉर्म भरें.
हमें अपने सुझाव, शिकायत या राय भेजें
अगर आपको Sample App for Matter से जुड़ी समस्याएं आ रही हैं, तो अपने एनवायरमेंट की पुष्टि करने के लिए यह तरीका अपनाएं:
अगर आपको सैंपल के तौर पर मिले ऐप्लिकेशन को इस्तेमाल करने के बारे में कोई सवाल पूछना है या कोड में कोई गड़बड़ी मिलती है, तो GitHub रिपॉज़िटरी में मौजूद Issue Tracker में जाकर, समस्याओं की शिकायत की जा सकती है:
तकनीकी सवालों पर Google से आधिकारिक दिशा-निर्देश पाने के लिए, स्मार्ट होम डेवलपर फ़ोरम का इस्तेमाल करें:
कम्यूनिटी से तकनीकी सहायता पाने के लिए, Stack Overflow पर google-smart-home टैग का इस्तेमाल करें: