Android के लिए होम मोबाइल SDK टूल

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

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

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

मोबाइल SDK टूल को अपने Android ऐप्लिकेशन से जोड़ना

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

  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 का इस्तेमाल करके, रनटाइम के दौरान होम मॉड्यूल की उपलब्धता देखी जा सकती है. ज़्यादा जानकारी के लिए, 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 टूल के असली उपयोगकर्ता के डेटा को कैसे मैनेज किया जाता है, यह जानने के लिए इस होम पेज के SDK टूल को Google Play के डेटा की सुरक्षा वाला सेक्शन देखें