تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

التفويض المستند إلى الغرض للمسألة القانونية

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

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

رموز الاستجابة السريعة لمعيار 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:

مثال على رمز الاستجابة السريعة لمعيار Matter

تنسيق الهدف

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

تنزيل نموذج تطبيق Intent-based Commissioning

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

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

الاستخدام

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

معاينة الكاميرا 1 معاينة الكاميرا 2

في حال التأكّد من بدء الاستخدام، ستظهر "أداة اختيار التطبيقات" مدعوم من تم إطلاق حزمة تطوير البرامج (SDK) الخاصة بتطبيق Google Home للأجهزة الجوّالة.

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

اختيار تطبيق - GHA اختيار تطبيق - تطبيقات أخرى

بعد ذلك، يتم تشغيل التطبيق المحدّد لتشغيل الجهاز.