होम मोबाइल SDK टूल को चालू किया जा रहा है

इस पेज पर, Google Home Mobile SDK में, कमीशनिंग के लिए चुने गए एपीआई की सुविधाओं के इस्तेमाल के बारे में बताया गया है.

कमीशन किए जा सकने वाले डिवाइस की खोज से जुड़ी सूचनाएं बंद करना

Android की हाफ़शीट सूचना
पहली इमेज: Android की हाफ़शीट सूचना का उदाहरण

डिफ़ॉल्ट रूप से, Google Play services पर Android uses "हाफ़शीट" सूचनाओं का इस्तेमाल करती है. ये सूचनाएं, मोबाइल डिवाइस की स्क्रीन के निचले आधे हिस्से को कवर करती हैं. इनकी मदद से, उपयोगकर्ताओं को यह जानकारी मिलती है कि आस-पास, कमीशन किए जा सकने वाले Matter डिवाइस मौजूद हैं.

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

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

इस एपीआई को लागू करने का तरीका, Google Home Sample App for Matter में देखा जा सकता है. ज़्यादा जानकारी के लिए, HalfSheetSuppressionObserver.kt देखें.

Matter कमीशनिंग के लिए सहायता की जानकारी देना

अगर कमीशनिंग के लिए Mobile SDK का इस्तेमाल किया जा रहा है, तो आपको ऐप्लिकेशन का पैकेज नेम जोड़ना होगा Google Home Developer Console में. साथ ही, हमारे Matter एपीआई लागू करने होंगे. इसके अलावा, यह भी बताना होगा कि आपका ऐप्लिकेशन, ACTION_COMMISSION_DEVICE इंटेंट को हैंडल करके, Matter कमीशनिंग की सुविधा देता है.

अपनी AndroidManifest.xml फ़ाइल में, application के एलान में यह intent-filter जोड़ें:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

रेफ़रंस के लिए, हमारे सैंपल ऐप्लिकेशन का मेनिफ़ेस्ट देखें.

ऐप्लिकेशन चुनने वाला टूल

ऐप्लिकेशन चुनने वाला टूल

कमीशनिंग की प्रोसेस के दौरान, आपका ऐप्लिकेशन, ऐप्लिकेशन चुनने वाले टूल में दो तरीकों से दिखता है:

  1. कोई ऐप्लिकेशन चुनें स्क्रीन पर.
  2. अगर उपयोगकर्ता कोई दूसरा ऐप्लिकेशन चुनें को चुनते हैं, तो यह इंस्टॉल किए गए अन्य ऐप्लिकेशन स्क्रीन पर दिखेगा.

सुझाए गए ऐप्लिकेशन

ऐप्लिकेशन चुनने वाले टूल में, दो सुझाए गए ऐप्लिकेशन दिखते हैं.

  • पहला हमेशा Google Home app (GHA) होता है.
  • दूसरा ऐप्लिकेशन, डिवाइस बनाने वाली कंपनी का पसंदीदा ऐप्लिकेशन होता है. हालांकि, यह तब दिखता है, जब डिवाइस के VID या PID से जुड़े Developer Console प्रोजेक्ट में इसकी जानकारी दी गई हो. डिवाइस बनाने वाली कंपनी का पसंदीदा कमिश्नर ऐप्लिकेशन

ऐप्लिकेशन, कोई ऐप्लिकेशन चुनें स्क्रीन पर दो स्थितियों में दिखते हैं.

  1. इंस्टॉल किया गया - Play services यह जांचती हैं कि ऐप्लिकेशन, ACTION_COMMISSION_DEVICE इंटेंट फ़िल्टर के साथ काम करता है या नहीं. अगर इंटेंट फ़िल्टर मौजूद नहीं है, तो उपयोगकर्ता को ऐप्लिकेशन अपडेट करने के लिए Play Store पर रीडायरेक्ट किया जाता है.
  2. इंस्टॉल नहीं किया गया - उपयोगकर्ता को आगे बढ़ने से पहले, ऐप्लिकेशन इंस्टॉल करने के लिए Play Store पर रीडायरेक्ट किया जाता है.