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

Google Home app (GHA) से मिलता-जुलता Android ऐप्लिकेशन बनाने के लिए, Google Home Sample App for MatterGoogle 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 के साथ काम करता है.
  • rootnode_dimmablelight_bCwGYSDpoe ऐप्लिकेशन का इस्तेमाल करके एक Matter वर्चुअल डिवाइस बनाएं. Google Home Developer Console में Matter इंटिग्रेशन बनाते समय, अपने वेंडर आईडी और अपने आईडी के तौर पर 0x8000 का इस्तेमाल करें.0xFFF1
  • all-clusters-app की मदद से एस्प्रेसिफ़ डिवाइस बनाएं. जब आप Developer Console में Matter इंटिग्रेशन बनाएं, तो 0xFFF1 को अपने वेंडर आईडी और 0x8001 को अपने प्रॉडक्ट आईडी के तौर पर इस्तेमाल करें.

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

इंस्टॉल करें

1. Sample App for Matter GitHub डेटा स्टोर करने की जगह में रिलीज़ सेक्शन पर जाएं. GHSAFM-1.4.1-default-debug.apk नाम वाले APK का पता लगाएं. इन्हें न चुनें: targetcommissioner:

   download APK डाउनलोड करना

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

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

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

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

कमीशन डिवाइस

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

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

मैटर फ़ैब्रिक क्या हैं?

Fabric, होम नेटवर्क में मौजूद डिवाइसों के बीच एक भरोसेमंद डोमेन होता है. इससे, वे आपस में बातचीत कर पाते हैं.

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

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

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

   

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

   

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

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

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

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

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

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

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

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

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

1. Sample App for Matter GitHub डेटा स्टोर करने की जगह में रिलीज़ सेक्शन पर जाएं. सबसे हाल के APK का पता लगाएं जिसका नाम GHSAFM-[version]-targetcommissioner है, उदाहरण के लिए GHSAFM-1.4.1-targetcommissioner-debug.apk:

   download टारगेट कमिश्नर डाउनलोड करें

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

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

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

   

ऐप्लिकेशन का नमूना Mobile SDK शेयर एपीआई को कॉल करता है और एक बार फिर, कंट्रोल को Play services पर ट्रांसफ़र कर दिया जाता है.

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

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

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

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

सेटिंग

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

आधी शीट की सूचना

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

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

डेवलपर सुविधाएं

सेटिंग स्क्रीन पर, डेवलपर के लिए बनाई गई सुविधाएं भी ऐक्सेस की जा सकती हैं.

डिवाइस और उपयोगकर्ता प्राथमिकताओं की सामग्री की समीक्षा करने के लिए, Logcat में DataStore डेटा संग्रह स्थान, नीचे दिए गए चरणों को पूरा करें:

1. डेटा स्टोर करने की जगह का लॉग लॉग करें पर क्लिक करें.

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

फ़ीडबैक और सहायता

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

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

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

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

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

• सैंपल-app-for-matter-android/issues

तकनीकी सवालों के बारे में Google से आधिकारिक सलाह पाने के लिए, स्मार्ट होम डेवलपर फ़ोरम का इस्तेमाल करें:

• स्मार्ट होम डेवलपर फ़ोरम

समुदाय से तकनीकी सहायता पाने के लिए, स्टैक ओवरफ़्लो पर google-smart-home टैग का उपयोग करें:

• स्टैक ओवरफ़्लो: google-smart-home