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

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

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

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

Matter क्यूआर कोड, MT:Y3.13OTB00KA0648G00 का सामान्य रूप लेते हैं जहां MT: प्रीफ़िक्स एक स्थिर वैल्यू होती है. साथ ही, सफ़िक्स 38-एन्कोडेड स्ट्रिंग होती है, जिसमें [A-Z0-9.-] वर्ण का इस्तेमाल होता है. प्रत्यय हमेशा कम से कम 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 सेवाओं पर सेट किए गए टारगेट पैकेज को Intent भेजा जाता है.

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 का इस्तेमाल शुरू करना
• Android पर ML किट की मदद से बारकोड स्कैन करना

इस्तेमाल का तरीका

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

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

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

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