Google ने Matter डिवाइसों के साथ इंटरैक्ट करने वाले Android ऐप्लिकेशन बनाने में आपकी मदद करने के लिए, Google Home Mobile SDK को डेवलप किया है. Mobile SDK में दो मुख्य एपीआई शामिल हैं. इनकी मदद से, आपके ऐप्लिकेशन Google फ़ैब्रिक के साथ डिवाइसों को कमीशन और शेयर कर सकते हैं.
किसी डिवाइस को Google फ़ैब्रिक से जोड़ने के बाद, आपके उपयोगकर्ता अपने डिवाइसों को Google Home app (GHA), Android के पावर कंट्रोल, आवाज़, और Nest के टच स्क्रीन डिवाइसों की मदद से कंट्रोल कर सकते हैं.
Mobile SDK की मदद से, कस्टम कमीशनिंग सेवा भी तय की जा सकती है. इसका इस्तेमाल, डिवाइसों को अन्य Matter ईकोसिस्टम में कमीशन करने के लिए किया जा सकता है.
Mobile SDK को अपने Android ऐप्लिकेशन में इंटिग्रेट करना
शुरू करने के लिए, यह तरीका अपनाएं:
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, दोनों के मेनिफ़ेस्ट में इस मॉड्यूल की डिपेंडेंसी शामिल है. अगर आपको Android ऐप्लिकेशन में Mobile SDK को इंटिग्रेट करना है, तो पक्का करें कि आपके ऐप्लिकेशन के उपयोगकर्ताओं के लिए 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 का इस्तेमाल करके, रनटाइम के दौरान Home मॉड्यूल की उपलब्धता देखी जा सकती है. ज़्यादा जानकारी के लिए, 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 Sample App का इस्तेमाल करना
Android ऐप्लिकेशन से Mobile SDK के काम करने का तरीका जानने के लिए, हमारी Sample App for Matter आज़माएं.
Sample App for Matter को आज़माएँ
अपना ऐप्लिकेशन बनाना
हमारा मकसद है कि आप इस सुविधा का इस्तेमाल तुरंत शुरू कर पाएं. इसलिए, हमने Sample App for Matter को ओपन-सोर्स कर दिया है. साथ ही, हमने एक कंपैनियन कोडलैब उपलब्ध कराया है. इससे आपको अपने Android प्रोजेक्ट के लिए, हमारे सैंपल कोड को पसंद के मुताबिक बनाने में मदद मिलेगी.
Sample App for Matter कोडलैब पर जाएं
संसाधन
Mobile SDK के बारे में ज़्यादा जानने के लिए, एपीआई के बारे में जानकारी देखें.
यह एसडीके, असली उपयोगकर्ताओं के डेटा का इस्तेमाल कैसे करता है, यह जानने के लिए Home Mobile SDK Google Play के डेटा की सुरक्षा वाले सेक्शन पर जाएं