Google Home Sample App for Matter, Google Home app (GHA) जैसा Android ऐप्लिकेशन बनाने के लिए, Google Home Mobile SDK का इस्तेमाल करता है. इस सैंपल ऐप्लिकेशन में ये सुविधाएं मिलती हैं:
- लोकल 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 वर्चुअल डिवाइस (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 डिवाइस को USB से कनेक्ट करें और फ़ाइल ट्रांसफ़र को चालू करें. इसके बाद, 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 मैनेज करता है. इससे, उपयोगकर्ताओं को एक जैसा अनुभव मिलता है. साथ ही, संवेदनशील अनुमतियों को मैनेज करने की ज़रूरत नहीं पड़ती. जैसे, Wi-Fi और Thread क्रेडेंशियल.
डिवाइसों को कंट्रोल करना
डेवलपमेंट फ़ैब्रिक, सैंपल ऐप्लिकेशन से ही 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 रिपॉज़िटरी के कॉन्टेंट की समीक्षा करने के लिए, यह तरीका अपनाएं:
रिपॉज़िटरी का कॉन्टेंट लॉग करें पर क्लिक करें.
डायलॉग बॉक्स में ठीक है पर क्लिक करें. इसके बाद, Logcat को चुनें.
सुझाव/राय देना या शिकायत करना और सहायता
Sample App for Matter के साथ डेवलपमेंट के अनुभव को बेहतर बनाने के बारे में अपने सुझाव, राय या शिकायत सबमिट करने के लिए, हमारा सुझाव/राय फ़ॉर्म भरें.
हमें सुझाव/राय दें या शिकायत करें
अगर आपको Sample App for Matter से जुड़ी समस्याएं आ रही हैं, तो अपने एनवायरमेंट की पुष्टि करने के लिए यह तरीका आज़माएं:
अगर आपको सैंपल ऐप्लिकेशन इस्तेमाल करने के बारे में कोई सवाल पूछना है या आपको कोड में कोई गड़बड़ी दिखती है, तो GitHub डेटा संग्रह में मौजूद समस्या ट्रैकर पर समस्याएं सबमिट की जा सकती हैं:
तकनीकी सवालों के बारे में Google से आधिकारिक दिशा-निर्देश पाने के लिए, स्मार्ट होम डेवलपर फ़ोरम का इस्तेमाल करें:
कम्यूनिटी से तकनीकी सहायता पाने के लिए, Stack Overflow पर google-smart-home टैग का इस्तेमाल करें: