العمولة المستندة إلى النوايا

على الرغم من أن حزمة Matter SDK توفّر واجهة برمجة تطبيقات تستند إلى Task لبدء تفويض Matter مع معلَمات متباينة، ومراقبة النتيجة، وإضافة بيانات الاعتماد اختياريًا، هناك حالات تكون فيها نقطة إدخال رمز الاستجابة السريعة فقط مطلوبة. على سبيل المثال، من تطبيق كاميرا عام يرغب في تقديم اختصار لبدء تشغيل عمولة عندما يظهر رمز استجابة سريعة في عدسة الكاميرا.

قبل المتابعة، تأكد من تحقيق جميع المتطلبات الأساسية.

رموز الاستجابة السريعة الخاصة بالمسألة القانونية

تأخذ رموز الاستجابة السريعة المسائل القانونية الشكل العام لـ MT:Y3.13OTB00KA0648G00، حيث تكون البادئة MT: ثابتة، وتكون اللاحقة سلسلة بترميز 38 باستخدام الأبجدية [A-Z0-9.-]. يجب أن تكون اللاحقة دائمًا 19 حرفًا، ولكنها قد تكون أطول كذلك.

يمكن تحديد ما إذا كان رمز الاستجابة السريعة يمثل رمز استجابة سريعة مهمًا باستخدام التعبير العادي التالي في جافا:

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

على سبيل المثال، يمثّل رمز الاستجابة السريعة التالي MT:Y3.13OTB00KA0648G00:

تنسيق Intent

يمكن استخدام تنسيق رمز الاستجابة السريعة هذا كعنوان URI لبدء تدفق التفويض من خلال إرسال Intent مع ACTION_VIEW ومعرّف الموارد المنتظم (URI) المحدّد في data والحزمة المستهدفة التي تم ضبطها على "خدمات Google Play":

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 عندما يظهر رمز استجابة سريعة متوافق مع المسائل القانونية في نطاق عدسة الكاميرا.

تنزيل نموذج تطبيق العمولة المستند إلى نية الشراء

يستفيد الرمز في هذا التطبيق النموذجي من مكتبات Android التالية:

• CameraX
• مسح الرمز الشريطي ضوئيًا

تعتبر المستندات التالية مفيدة أيضًا لفهم الشفرة المكتوبة لنموذج التطبيق هذا:

• بدء استخدام كاميرا X
• مسح الرموز الشريطية ضوئيًا باستخدام ML Kit على Android

الاستخدام

عند بدء تشغيل التطبيق، تظهر معاينة الكاميرا على الشاشة. عندما يتم اكتشاف رمز استجابة سريعة لجهاز Matter، يظهر مربّع حوار لتأكيد ما إذا كان يجب إجراء التكليف لجهاز Matter هذا:

إذا تم تأكيد العمولة، فسيتم إطلاق "منتقي التطبيقات" الذي يدعمه Google Home Mobile SDK.

يعرض منتقي التطبيقات مبدئيًا مجموعة من التطبيقات التلقائية للتفويض (على سبيل المثال، تطبيق Google Home كما هو موضَّح في لقطة الشاشة الأولى). في حال نقر المستخدم على "اختيار تطبيق آخر"، ستظهر التطبيقات الأخرى التي تتوافق مع تدفُّق عمولة حزمة تطوير البرامج (SDK) للأجهزة الجوّالة من Google Home (راجِع لقطة الشاشة الثانية).

بعد ذلك يتم تشغيل التطبيق المحدد لإجراء تفويض للجهاز.