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

على الرغم من أنّ حزمة تطوير البرامج (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

تنسيق النيّة

يمكن استخدام تنسيق رمز الاستجابة السريعة هذا كعنوان URL لبدء عملية التفعيل من خلال إرسال Intent مع ACTION_VIEW وعنوان URL المحدّد في 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 عندما يظهر رمز استجابة سريعة متوافق مع Matter في عدسة الكاميرا.

تنزيل نموذج تطبيق "إعداد الأجهزة بالاستناد إلى الأهداف"

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

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

الاستخدام

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

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

في حال تأكيد عملية الإعداد، يتم تشغيل "أداة اختيار التطبيقات" المتوافقة مع IDE Google Home Mobile SDK.

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

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

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