मैटर के लिए Google Home सैंपल ऐप्लिकेशन

Google Home Sample App for Matter Google Home Mobile SDK का इस्तेमाल करके एक Android ऐप्लिकेशन बनाता है. यह ऐप्लिकेशन, Google Home app (GHA) जैसा होता है. इस सैंपल ऐप्लिकेशन में ये सुविधाएं मिलती हैं:

• फ़िज़िकल और वर्चुअल Matter डिवाइसों को, लोकल 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 के ख़िलाफ़ सैंपल ऐप्लिकेशन का इस्तेमाल करने पर, उसकी जांच करना ज़्यादा आसान होगा.
  • Matter Virtual Device बनाएं जिसमें rootnode_dimmablelight_bCwGYSDpoe ऐप्लिकेशन का इस्तेमाल किया गया हो. जब आप Google Home Developer Console में Matter इंटिग्रेशन बनाते हैं, तो वेंडर आईडी के तौर पर 0xFFF1 और प्रॉडक्ट आईडी के तौर पर 0x8000 का इस्तेमाल करें.
  • Espressif डिवाइस बनाएं all-clusters-app की मदद से. Developer Console में Matter इंटिग्रेशन बनाते समय, वेंडर आईडी के तौर पर `0xFFF1` और प्रॉडक्ट आईडी के तौर पर `0x8001` का इस्तेमाल करें.MatterDeveloper Console0xFFF10x8001

Matter के लिए Sample App for Matter की मदद से डिवाइसों को कमीशन करने और कंट्रोल करने के लिए, आपको हब की ज़रूरत नहीं होती. जैसे, Google Nest Hub (2nd gen).

इंस्टॉल करें

1. GitHub रिपॉज़िटरी में, रिलीज़ सेक्शन पर जाएं.Sample App for Matter हाल ही की रिलीज़ के लिए, ऐसेट सेक्शन में ऐसे APK का पता लगाएं जिसका नाम है GHSAFM-version-default-debug.apk. targetcommissioner को न चुनें.

2. Android डीबग ब्रिज (adb) इंस्टॉल करें:

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

3. अपने Android डिवाइस को यूएसबी से कनेक्ट करें और फ़ाइल ट्रांसफ़र की सुविधा चालू करें. इसके बाद, APK इंस्टॉल करें:

   $ adb unroot && adb install GHSAFM-version-default-debug.apk
   

डिवाइसों को कमीशन करना

सैंपल ऐप्लिकेशन को पहली बार लॉन्च करने पर, आपको एक डायलॉग दिखेगा. इसमें, Sample App for Matter कोडलैब का लिंक होगा. अगर आपने यह मैसेज दोबारा न दिखाएं को चुना है, तो ऐप्लिकेशन के एडमिन सेक्शन में जाकर, अपनी प्राथमिकताएं अपडेट करके डायलॉग को कभी भी वापस लाया जा सकता है.

अगले चरणों में, Matter डिवाइस को लोकल Android फ़ैब्रिक में जोड़ा जाएगा. इसके साथ ही, एक डेवलपमेंट फ़ैब्रिक भी जोड़ा जाएगा, जो सिर्फ़ सैंपल ऐप्लिकेशन के लिए लोकल होगा.

Matter फ़ैब्रिक क्या होते हैं?

एक Matter फ़ैब्रिक, होम नेटवर्क में मौजूद डिवाइसों के बीच भरोसे का एक शेयर किया गया डोमेन होता है. इसकी मदद से, डिवाइस एक-दूसरे से संपर्क कर सकते हैं.

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

Matter डिवाइस को कमीशन करने के लिए, यह तरीका अपनाएं:

1. कमीशनिंग की प्रोसेस शुरू करने के लिए, add डिवाइस जोड़ें बटन पर टैप करें.

   

2. इसके बाद, कंट्रोल Google Play services को ट्रांसफ़र कर दिया जाता है. इसे Mobile SDK को कॉल करके लॉन्च किया जाता है . डिवाइस के मालिकाना हक की पुष्टि करने के लिए, क्यूआर कोड स्कैन करें या पेयरिंग कोड का इस्तेमाल करें पर टैप करें.

   

3. कमीशनिंग पूरी होने के बाद, डिवाइस का नाम डालें. इसके बाद, हो गया पर टैप करें.

अब आपका डिवाइस, लोकल Android फ़ैब्रिक और डेवलपमेंट फ़ैब्रिक, दोनों से कनेक्ट हो गया है.

डिवाइसों को कमीशन करते समय, कमीशनिंग से जुड़ा सारा काम और उससे जुड़ी स्क्रीन, Play services मैनेज करती है. इससे उपयोगकर्ताओं को एक जैसा अनुभव मिलता है. साथ ही, संवेदनशील अनुमतियों को मैनेज करने की ज़रूरत नहीं पड़ती. जैसे, वाई-फ़ाई और Thread के क्रेडेंशियल.

डिवाइसों को कंट्रोल करें

डेवलपमेंट फ़ैब्रिक, Matter डिवाइसों को सैंपल ऐप्लिकेशन से ही कंट्रोल करने के लिए क्रेडेंशियल बनाता है.

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

डिवाइस शेयर करें

Matter की Matter खास जानकारी में, डिवाइस शेयर करने को मल्टी-एडमिन फ़्लो कहा जाता है. किसी डिवाइस को सैंपल ऐप्लिकेशन में कमीशन करने के बाद, उसे आसानी से दूसरे इकोसिस्टम के साथ शेयर किया जा सकता है.

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

1. GitHub रिपॉज़िटरी में, रिलीज़ सेक्शन पर जाएं.Sample App for Matter हाल ही की रिलीज़ के लिए, ऐसेट सेक्शन में ऐसे APK का पता लगाएं जिसका नाम है GHSAFM-version-targetcommissioner-debug.apk. default को न चुनें.

2. टारगेट कमिश्नर इंस्टॉल करें.

   $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
   

3. डिवाइस की जानकारी दिखाने के लिए, होम स्क्रीन पर डिवाइस पर टैप करें. शेयर करें पर टैप करें.

   

सैंपल ऐप्लिकेशन, Mobile SDK Share API को कॉल करता है. इसके बाद, कंट्रोल फिर से Play services को ट्रांसफ़र कर दिया जाता है.

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

1. सेटअप कोड की मदद से मैन्युअल तरीके से शेयर करना. यह कोड, टारगेट कमिश्नर ऐप्लिकेशन के साथ शेयर किया जाना चाहिए
2. लोकल Android ऐप्लिकेशन की मदद से शेयर करना. इस ऐप्लिकेशन को Matter कमिश्नर के तौर पर रजिस्टर किया गया हो

टारगेट कमिश्नर ऐप्लिकेशन को GHSAFM-TC के तौर पर लेबल किया जाता है. अपने डिवाइस को शेयर करने के लिए, सैंपल ऐप्लिकेशन के इस इंस्टेंस पर टैप करें.

इसके बाद, बाहरी ऐप्लिकेशन (टारगेट कमिश्नर), डिवाइस को अपने फ़ैब्रिक में कमीशन करने की प्रोसेस पूरी करता है.

सेटिंग

होम स्क्रीन पर, सेटिंग settings आइकॉन पर क्लिक करें. यहां, उपयोगकर्ता की प्राथमिकताएं अपडेट करने, मदद पाने, और ऐप्लिकेशन के बारे में ज़्यादा जानने के विकल्प मिलते हैं.

Halfsheet notification

सेटिंग स्क्रीन से, Matter डिवाइसों के लिए, कमीशन किए जा सकने वाले डिवाइसों की खोज से जुड़ी सूचनाएं बंद की जा सकती हैं.

अगर आपका ऐप्लिकेशन, Matter डिवाइसों की खोज या कमीशनिंग का अपना फ़्लो उपलब्ध कराता है, तो इन सूचनाओं को बंद किया जा सकता है, ताकि कोई रुकावट न आए. ज़्यादा जानकारी के लिए, कमीशन किए जा सकने वाले डिवाइसों की खोज से जुड़ी सूचनाएं बंद करना लेख पढ़ें.

डेवलपर यूटिलिटी

सेटिंग स्क्रीन से, डेवलपर यूटिलिटी को भी ऐक्सेस किया जा सकता है.

डिवाइस और उपयोगकर्ता की प्राथमिकताओं के DataStore रिपॉज़िटरी का कॉन्टेंट देखने के लिए Logcat में, यह तरीका अपनाएं:

1. लॉग रिपॉज़िटरी का कॉन्टेंट पर क्लिक करें.

2. डायलॉग में ठीक है पर क्लिक करें. इसके बाद, Logcat देखें.

सुझाव/राय/शिकायत और सहायता

Sample App for Matter की मदद से, डेवलपमेंट के अनुभव को बेहतर बनाने के बारे में अपने सुझाव या राय देने के लिए, हमारा सुझाव/राय/शिकायत फ़ॉर्म भरें.

हमें अपना सुझाव/राय/शिकायत भेजें

अगर आपको Sample App for Matter में समस्याएं आ रही हैं, तो अपने एनवायरमेंट की पुष्टि करने के लिए, यह तरीका अपनाएं:

• मॉड्यूल और सेवाओं की Matter पुष्टि करना

अगर सैंपल ऐप्लिकेशन के इस्तेमाल के बारे में आपके कोई सवाल हैं या आपको कोड में कोई गड़बड़ी मिलती है, तो GitHub रिपॉज़िटरी में मौजूद, Issue Tracker में समस्याएं सबमिट की जा सकती हैं:

• sample-apps-for-matter-android/issues

तकनीकी सवालों के बारे में Google से आधिकारिक सलाह पाने के लिए, Smart Home Developer Forum का इस्तेमाल करें:

• Smart Home Developer Forum

कम्यूनिटी से तकनीकी सहायता पाने के लिए, Stack Overflow पर google-smart-home टैग का इस्तेमाल करें:

• Stack Overflow: google-smart-home