Android के लिए Home Mobile SDK

Matter डिवाइसों के साथ इंटरैक्ट करने वाले Android ऐप्लिकेशन बनाने में आपकी मदद करने के लिए, Google ने Google Home Mobile SDK को डेवलप किया है. Mobile SDK में दो मुख्य एपीआई शामिल हैं. इनकी मदद से, आपके ऐप्लिकेशन Google Fabric के साथ डिवाइसों को कमिशन कर सकते हैं और शेयर कर सकते हैं.

किसी डिवाइस को Google Fabric में जोड़ने के बाद, आपके उपयोगकर्ता Google Home app (GHA), Android पावर कंट्रोल, आवाज़, और Nest टच स्क्रीन डिवाइसों की मदद से अपने डिवाइसों को कंट्रोल कर सकते हैं.

Mobile SDK की मदद से, कस्टम कमीशनिंग सेवा भी तय की जा सकती है. इसका इस्तेमाल, डिवाइसों को अन्य Matter नेटवर्क पर कमीशन करने के लिए किया जा सकता है.

अपने Android ऐप्लिकेशन में Mobile SDK टूल इंटिग्रेट करना

शुरू करने के लिए, यह तरीका अपनाएं:

  1. Google Play services सेट अप करें पर दिए गए निर्देशों का पालन करें.

  2. अपनी 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 के सैंपल ऐप्लिकेशन का इस्तेमाल करना

यह जानने के लिए कि 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 के डेटा की सुरक्षा वाले सेक्शन पर जाएं