Matter डिवाइसों के साथ इंटरैक्ट करने वाले Android ऐप्लिकेशन बनाने में आपकी मदद करने के लिए, Google ने Google Home Mobile SDK को डेवलप किया है. Mobile SDK में दो मुख्य एपीआई शामिल हैं. इनकी मदद से, आपके ऐप्लिकेशन Google फ़ैब्रिक के साथ डिवाइसों को कमीशन और शेयर कर सकते हैं.
Google फ़ैब्रिक में किसी डिवाइस को जोड़ने के बाद, आपके उपयोगकर्ता उसे Google Home app (GHA), Android पावर कंट्रोल, बोलकर, और Nest टच स्क्रीन डिवाइसों से कंट्रोल कर सकते हैं.
Mobile SDK की मदद से, कमीशन करने की कस्टम सेवा को भी तय किया जा सकता है. इसका इस्तेमाल करके, डिवाइसों को अन्य Matter नेटवर्क से जोड़ा जा सकता है.
अपने Android ऐप्लिकेशन में Mobile SDK को इंटिग्रेट करना
शुरू करने के लिए, यह तरीका अपनाएं:
Google Play services सेट अप करें में दिए गए निर्देशों का पालन करें.
अपनी
build.gradleफ़ाइल में Play services डिपेंडेंसी जोड़ें:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
मॉड्यूल की डिलीवरी पक्का करना
Play services home मॉड्यूल ज़रूरी नहीं है. इसलिए, Matter की सुविधा उपयोगकर्ता के डिवाइस पर सिर्फ़ तब मौजूद होगी, जब डिवाइस पर मौजूद कोई ऐप्लिकेशन अपनी AndroidManifest.xml फ़ाइल में, Play services मॉड्यूल की ज़रूरी डिपेंडेंसी के बारे में बताएगा.
GHA और Google Home Sample App for Matter, दोनों के मेनिफ़ेस्ट में इस मॉड्यूल डिपेंडेंसी को शामिल किया गया है. अगर Mobile SDK को अपने Android ऐप्लिकेशन में इंटिग्रेट किया जा रहा है, तो अपने ऐप्लिकेशन के उपयोगकर्ताओं के लिए Matter की सुविधा चालू करने के लिए, अपनी AndroidManifest.xml फ़ाइल में application एलान में यह service ब्लॉक जोड़ें:
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
यह सुविधा सिर्फ़ उन Android डिवाइसों पर काम करती है जिनमें Play services 22.50.14 या इसके बाद का वर्शन मौजूद हो.
लागू करने का उदाहरण देखने के लिए, Sample App for Matter का मेनिफ़ेस्ट देखें.
ModuleInstallClient का इस्तेमाल करके, रनटाइम के दौरान होम मॉड्यूल की उपलब्धता देखी जा सकती है. ज़्यादा जानकारी के लिए,
ModuleInstallClient की मदद से एपीआई की उपलब्धता पक्का करना
पेज देखें.
अन्य Android ऐप्लिकेशन को कॉल करना
अगर Android 11 या इसके बाद के वर्शन का इस्तेमाल किया जा रहा है, तो आपको AndroidManifest.xml में queries ब्लॉक को शामिल करना होगा, ताकि आपका ऐप्लिकेशन दूसरे ऐप्लिकेशन को कॉल कर सके.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
ज़्यादा जानकारी के लिए, Android पर पैकेज की जानकारी दिखने की सुविधा को फ़िल्टर करना लेख पढ़ें.
Matter के लिए, Google Home के सैंपल के तौर पर मिले ऐप्लिकेशन का इस्तेमाल करना
Android ऐप्लिकेशन में Mobile SDK के काम करने का तरीका जानने के लिए, हमारा Sample App for Matter आज़माएं.
Sample App for Matter को आज़माएं
अपना ऐप्लिकेशन बनाना
जल्द से जल्द शुरुआत करने में आपकी मदद करने के लिए, हमने Sample App for Matter को ओपन-सोर्स किया है. साथ ही, एक कंपैनियन कोडलैब उपलब्ध कराया है. इससे आपको अपने Android प्रोजेक्ट के लिए, हमारे सैंपल कोड को पसंद के मुताबिक बनाने में मदद मिलेगी.
Sample App for Matter कोडलैब पर जाएं
संसाधन
Mobile SDK के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस देखें.
यह SDK टूल, असली उपयोगकर्ता के डेटा को कैसे मैनेज करता है, यह जानने के लिए Home Mobile SDK Google Play के डेटा की सुरक्षा वाले सेक्शन पर जाएं