Google Home Sample App for Matter, Google Home app (GHA) जैसा Android ऐप्लिकेशन बनाने के लिए, Google Home Mobile SDK का इस्तेमाल करता है. इस सैंपल ऐप्लिकेशन में ये सुविधाएं मिलती हैं:
- फ़िज़िकल और वर्चुअल Matter डिवाइसों को Local Android फ़ैब्रिक से कनेक्ट करना
- फ़िज़िकल और वर्चुअल डिवाइसों को डेवलपमेंट फ़ैब्रिक में कमीशन करना
- अपने डेवलपमेंट फ़ैब्रिक पर मौजूद डिवाइसों को कंट्रोल करना. जैसे, लाइट चालू करना
- मल्टी-एडमिन की सुविधाओं की मदद से, डेवलपमेंट फ़ैब्रिक पर मौजूद डिवाइसों को अन्य ऐप्लिकेशन के साथ शेयर किया जा सकता है. इसके अलावा, अन्य ऐप्लिकेशन से शेयर किए गए डिवाइसों को डेवलपमेंट फ़ैब्रिक में शामिल किया जा सकता है
- डेवलपर के लिए उपलब्ध टूल
इस गाइड में, 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 रिपॉज़िटरी में, रिलीज़ सेक्शन पर जाएं. सबसे हाल की रिलीज़ के लिए, ऐसेट सेक्शन में जाकर
GHSAFM-version-default-debug.apkनाम का APK ढूंढें.targetcommissionerको न चुनें.Android डीबग ब्रिज (adb) इंस्टॉल करें:
अपने Android डिवाइस को यूएसबी से कनेक्ट करें और फ़ाइल ट्रांसफ़र चालू करें. इसके बाद, APK इंस्टॉल करें:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
डिवाइसों को सेट अप करना
सैंपल ऐप्लिकेशन को पहली बार लॉन्च करने पर, आपको एक डायलॉग दिखेगा. इसमें Sample App for Matter कोडलैब का लिंक होगा. यह मैसेज दोबारा न दिखाएं विकल्प चुनने पर, ऐप्लिकेशन के एडमिन सेक्शन में जाकर अपनी प्राथमिकताओं को अपडेट करके, इस डायलॉग को कभी भी वापस लाया जा सकता है.
अगले चरणों में, आपको Matter डिवाइस को लोकल Android फ़ैब्रिक में जोड़ना होगा. साथ ही, एक डेवलपमेंट फ़ैब्रिक जोड़ना होगा, जो सिर्फ़ सैंपल ऐप्लिकेशन के लिए लोकल हो.
मैटर फ़ैब्रिक क्या होते हैं?
Matter फ़ैब्रिक, होम नेटवर्क में मौजूद डिवाइसों के बीच एक शेयर किया गया भरोसेमंद डोमेन होता है. इससे डिवाइस एक-दूसरे से कम्यूनिकेट कर पाते हैं.
डिवाइसों में एक या उससे ज़्यादा फ़ैब्रिक हो सकते हैं. ये फ़ैब्रिक, किसी प्लैटफ़ॉर्म, ऐप्लिकेशन या एक साथ इंटरैक्ट करने वाले डिवाइसों के ग्रुप से जुड़े होते हैं. फ़ैब्रिक का एक यूनीक आईडी होता है. साथ ही, डिवाइस क्रेडेंशियल और सर्टिफ़िकेट अथॉरिटी (सीए) का एक ही सेट शेयर करते हैं. ये क्रेडेंशियल, Matter के चालू होने के दौरान असाइन किए जाते हैं.
Matter डिवाइस को चालू करने के लिए, यह तरीका अपनाएं:
डिवाइस को चालू करने की प्रोसेस शुरू करने के लिए, डिवाइस जोड़ें बटन पर टैप करें.
इसके बाद, कंट्रोल Google Play services को ट्रांसफ़र कर दिया जाता है. इसे Mobile SDK को किए गए कॉल से लॉन्च किया जाता है. डिवाइस पर मालिकाना हक साबित करने के लिए, क्यूआर कोड स्कैन करें या दूसरे डिवाइस से जोड़ने वाला कोड इस्तेमाल करें पर टैप करें.
कमीशनिंग पूरी होने के बाद, डिवाइस का नाम डालें. इसके बाद, हो गया पर टैप करें.
अब आपका डिवाइस, लोकल Android फ़ैब्रिक और डेवलपमेंट फ़ैब्रिक, दोनों से कनेक्ट हो गया है.
डिवाइसों को चालू करने से जुड़े सभी काम और उनसे जुड़ी स्क्रीन, Play services मैनेज करता है. इससे उपयोगकर्ताओं को एक जैसा अनुभव मिलता है. साथ ही, संवेदनशील अनुमतियों को मैनेज करने की ज़रूरत नहीं पड़ती. उदाहरण के लिए, वाई-फ़ाई और थ्रेड क्रेडेंशियल.
डिवाइसों को कंट्रोल करना
डेवलपमेंट फ़ैब्रिक, Matter डिवाइसों को कंट्रोल करने के लिए क्रेडेंशियल बनाता है. ऐसा सीधे तौर पर सैंपल ऐप्लिकेशन से किया जाता है.
होम स्क्रीन से, अपने डिवाइस को चालू या बंद किया जा सकता है. डिवाइस की जानकारी ऐक्सेस करने के लिए, डिवाइस पर टैप करें.
डिवाइस शेयर करें
किसी डिवाइस को शेयर करने की सुविधा को Matter स्पेसिफ़िकेशन में एक से ज़्यादा एडमिन वाला फ़्लो कहा जाता है. किसी डिवाइस को सैंपल ऐप्लिकेशन के साथ कमीशन करने के बाद, उसे अन्य इकोसिस्टम के साथ आसानी से शेयर किया जा सकता है.
अपने Matter डिवाइस को अन्य इकोसिस्टम के साथ शेयर करने के लिए, आपको अपने Android डिवाइस पर कोई दूसरा प्लैटफ़ॉर्म इंस्टॉल करना होगा. यह बाहरी प्लैटफ़ॉर्म, टारगेट कमिशनर बन जाता है. हमने सैंपल ऐप्लिकेशन का एक और इंस्टेंस बनाया है. इसका इस्तेमाल टारगेट कमिशनर के तौर पर किया जा सकता है.
Sample App for Matter GitHub रिपॉज़िटरी में, रिलीज़ सेक्शन पर जाएं. सबसे हाल की रिलीज़ के लिए, ऐसेट सेक्शन में जाकर
GHSAFM-version-targetcommissioner-debug.apkनाम का APK ढूंढें.defaultको न चुनें.टारगेट कमिश्नर को इंस्टॉल करें.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkहोम स्क्रीन पर, डिवाइस की जानकारी देखने के लिए उस पर टैप करें. शेयर करें पर टैप करें.
सैंपल ऐप्लिकेशन, Mobile SDK Share API को कॉल करता है. इसके बाद, कंट्रोल फिर से Play services को ट्रांसफ़र कर दिया जाता है.
इसके बाद, एक शेयर शीट दिखेगी. इसमें आपको वह ऐप्लिकेशन या प्लैटफ़ॉर्म चुनने का विकल्प मिलेगा जिससे आपको डिवाइस को जोड़ना है. इस स्क्रीन पर, डिवाइस शेयर करने के दो तरीके दिए गए हैं:
- मैन्युअल तरीके से, सेटअप कोड के ज़रिए. यह कोड, टारगेट कमिशनर ऐप्लिकेशन के साथ शेयर किया जाता है
- किसी ऐसे स्थानीय Android ऐप्लिकेशन के साथ जो Matter कमिश्नर के तौर पर रजिस्टर हो
टारगेट किए गए कमिश्नर ऐप्लिकेशन को GHSAFM-TC के तौर पर लेबल किया गया है. अपने डिवाइस को शेयर करने के लिए, सैंपल ऐप्लिकेशन के इस इंस्टेंस पर टैप करें.
इसके बाद, बाहरी ऐप्लिकेशन (टारगेट कमिशनर) डिवाइस को अपने फ़ैब्रिक में कमीशन करता है.
सेटिंग
होम स्क्रीन पर, सेटिंग आइकॉन पर क्लिक करें. यहां आपको ये विकल्प मिलते हैं: उपयोगकर्ता की प्राथमिकताओं को अपडेट करना, मदद पाना, और ऐप्लिकेशन के बारे में ज़्यादा जानना.
हाफ़शीट सूचना
सेटिंग स्क्रीन पर जाकर, Matter डिवाइसों के लिए, कमीशन पाने में मदद करने वाली सूचनाएं पाने की सुविधा बंद की जा सकती है.
अगर आपका ऐप्लिकेशन, Matter खोज या कमीशनिंग का अपना फ़्लो उपलब्ध कराता है, तो हो सकता है कि आप इन सूचनाओं को बंद करना चाहें, ताकि कोई रुकावट न आए. ज़्यादा जानकारी के लिए, कमीशन पाने में मदद करने वाली डिस्कवरी से जुड़ी सूचनाएं बंद करना लेख पढ़ें.
डेवलपर के लिए काम के टूल
सेटिंग स्क्रीन से, डेवलपर टूल को भी ऐक्सेस किया जा सकता है.
Logcat में, डिवाइस और उपयोगकर्ता की प्राथमिकताओं से जुड़े DataStore रिपॉज़िटरी का कॉन्टेंट देखने के लिए, यह तरीका अपनाएं:
लॉग रिपॉज़िटरी का कॉन्टेंट पर क्लिक करें.
डायलॉग बॉक्स में, OK पर क्लिक करें. इसके बाद, Logcat को चुनें.
सुझाव/राय/शिकायत और सहायता
Sample App for Matter के साथ डेवलपमेंट के अनुभव को बेहतर बनाने के बारे में अपने सुझाव/राय देने या शिकायत करने के लिए, हमारा फ़ीडबैक फ़ॉर्म भरें.
अगर आपको Sample App for Matter से जुड़ी समस्याएं आ रही हैं, तो अपने एनवायरमेंट की पुष्टि करने के लिए यह तरीका अपनाएं:
अगर आपको सैंपल ऐप्लिकेशन का इस्तेमाल करने के बारे में कोई सवाल पूछना है या आपको कोड में कोई गड़बड़ी मिली है, तो GitHub रिपॉज़िटरी में मौजूद Issue Tracker में समस्याएं सबमिट की जा सकती हैं:
तकनीकी सवालों के बारे में Google से आधिकारिक दिशा-निर्देश पाने के लिए, Smart Home Developer Forum का इस्तेमाल करें:
कम्यूनिटी से तकनीकी सहायता पाने के लिए, Stack Overflow पर google-smart-home टैग का इस्तेमाल करें: