मामले के लिए इंटेंट पर आधारित कमीशन

Matter SDK टूल, अलग-अलग पैरामीटर के साथ Matter को कमिशन करने, नतीजे को देखने, और ज़रूरत पड़ने पर क्रेडेंशियल जोड़ने के लिए, Task पर आधारित एपीआई उपलब्ध कराता है. हालांकि, कुछ मामलों में सिर्फ़ क्यूआर कोड के एंट्री पॉइंट की ज़रूरत होती है. उदाहरण के लिए, किसी सामान्य कैमरा ऐप्लिकेशन से, जो व्यूफ़ाइंडर में क्यूआर कोड दिखने पर, कमिशनिंग शुरू करने के लिए शॉर्टकट उपलब्ध कराना चाहता है.

जारी रखने से पहले, पक्का करें कि सभी ज़रूरी शर्तें पूरी हो गई हों.

Matter के क्यूआर कोड

Matter क्यूआर कोड का सामान्य फ़ॉर्मैट MT:Y3.13OTB00KA0648G00 होता है. इसमें MT: प्रीफ़िक्स एक कॉन्स्टेंट होता है और सफ़िक्स, [A-Z0-9.-] वर्णमाला का इस्तेमाल करके, बेस 38 में एन्कोड की गई स्ट्रिंग होती है. सफ़िक्स में कम से कम 19 वर्ण होने चाहिए. हालांकि, इसमें ज़्यादा वर्ण भी हो सकते हैं.

यह पता लगाया जा सकता है कि कोई क्यूआर कोड, Matter क्यूआर कोड है या नहीं. इसके लिए, Java में इस रेगुलर एक्सप्रेशन का इस्तेमाल करें:

fun isMatterQrCode(value: String): Boolean {
  return value.matches(Regex("""MT:[A-Z0-9.-]{19,}"""))
}

उदाहरण के लिए, नीचे दिया गया क्यूआर कोड MT:Y3.13OTB00KA0648G00 दिखाता है:

इंटेंट फ़ॉर्मैट

इस क्यूआर कोड फ़ॉर्मैट का इस्तेमाल, यूआरआई के तौर पर किया जा सकता है. इससे, कमिशनिंग फ़्लो शुरू करने के लिए, ACTION_VIEW के साथ Intent भेजा जा सकता है. साथ ही, data में बताए गए यूआरआई और Google Play services पर सेट किए गए टारगेट पैकेज का इस्तेमाल किया जा सकता है:

fun startCommissioning(context: Context, qrCodeString: String): Boolean {
  val intent =
    Intent(Intent.ACTION_VIEW)
      .setData(Uri.parse(qrCodeString))
      .setPackage("com.google.android.gms")

  try {
    context.startActivity(intent)
    return true
  } catch (ex: ActivityNotFoundException) {
    // Supporting Play Services version not available.
    return false
  }
}

सैंपल ऐप्लिकेशन

इस सैंपल ऐप्लिकेशन में, कैमरे के व्यूफ़ाइंडर में Matter के मुताबिक क्यूआर कोड दिखने पर, Matter डिवाइस को कमिशन करने का तरीका बताया गया है.

इंटेंट पर आधारित कमीशनिंग का सैंपल ऐप्लिकेशन डाउनलोड करें

इस सैंपल ऐप्लिकेशन में मौजूद कोड, इन Android लाइब्रेरी का इस्तेमाल करता है:

• CameraX
• बारकोड स्कैन करना

इस सैंपल ऐप्लिकेशन के लिए लिखे गए कोड को समझने के लिए, ये दस्तावेज़ भी काम के हैं:

• CameraX का इस्तेमाल शुरू करना
• Android पर ML Kit की मदद से बारकोड स्कैन करना

इस्तेमाल

ऐप्लिकेशन शुरू होने पर, स्क्रीन पर कैमरे की झलक दिखती है. जब किसी Matter डिवाइस का क्यूआर कोड डिटेक्ट होता है, तो एक डायलॉग दिखता है. इसमें यह पुष्टि की जाती है कि उस Matter डिवाइस को कमिशन किया जाना चाहिए या नहीं:

अगर कमिशन करने की पुष्टि हो जाती है, तो Google Home Mobile SDK के साथ काम करने वाला "ऐप्लिकेशन पिकर" लॉन्च हो जाता है.

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

इसके बाद, चुने गए ऐप्लिकेशन को डिवाइस को चालू करने के लिए लॉन्च किया जाता है.