مشرفون متعدّدون لواجهة برمجة التطبيقات Commissioning API على Android

تتيح واجهة برمجة التطبيقات Commissioning API على Android إمكانية الإدارة المتعدّدة (أو الإدارة من قِبل عدة مشرفين) لبروتوكول Matter، ما يعني أنّ واجهة برمجة التطبيقات Commissioning API يمكن أن تكون بمثابة مفوّض Matter أساسي أو ثانوي، ويمكنك إضافة المفوّض الخاص بك:

  • بصفتك مفوّض Matter أساسي Matter

    • في هذا الوضع، تتم إضافة شبكة Google أولاً باستخدام تجربة المستخدم من Google.
    • يمكنك إضافة مفوّض مخصّص.
      • يتم استدعاء المفوّض بعد إضافة شبكة Google إلى الجهاز، ثم يُعاد فتح نافذة تفويض Matter.Matter
      • إذا تعذّر على Google إكمال عملية التفويض لشبكتها أولاً لأي سبب، لن يتم تشغيل خدمة التفويض المخصّصة.

  • بصفتك مفوّض Matter ثانوي:

    • في هذا الوضع، يمكنك تنفيذ تجربة المستخدم الخاصة بك لتفويض الأجهزة وإضافتها إلى شبكتك (أو إلى شبكات أخرى).
    • يمكن استدعاء واجهة برمجة التطبيقات Google Commissioning API لاحقًا باستخدام نافذة تفويض مفتوحة لإضافة شبكة Google. في هذا الوضع، تنصح Google بشدة بأن يطلب التطبيق من المستخدمين بشكلٍ نشط إضافة شبكة Google (باستخدام واجهة برمجة التطبيقات Commissioning API) بعد اكتمال عملية التفويض، وذلك عندما يمنحك المستخدم النهائي إذنًا باستخدام واجهات برمجة التطبيقات Home APIs.

كيفية استخدام واجهة برمجة التطبيقات Commissioning API بصفتك مفوّض Matter أساسي

تعرض هذه الخطوات عملية تفويض Matter كاملة الميزات المفضّلة لدى Google:Matter

  1. يبدأ المستخدم عملية التفويض في التطبيق. على سبيل المثال، ينقر المستخدم على زر يحمل التصنيف إضافة جهاز.

  2. تتولى تجربة المستخدم من Google عملية التفويض وتعرض شاشة مسح رمز الاستجابة السريعة، ما يسمح للمستخدم بمسح رمز الاستجابة السريعة ضوئيًا لبدء عملية الإعداد.Matter

  3. في شاشة ربط هذا الجهاز بحسابك على Google ، ينقر المستخدم على أوافق لإضافة جهاز إلى نظام Google الأساسي. إذا نقر المستخدم بدلاً من ذلك على إلغاء في هذه الشاشة، تنتهي جميع عمليات تفويض الأجهزة على الفور.

  4. في شاشة اختيار منزل ، يختار المستخدم المنزل الذي يمكنه من خلاله التحكّم في الجهاز. إذا لم يكن أي منزل متاحًا، يتم إنشاء منزل جديد. إذا لم يتم العثور على أي مراكز مناسبة في المنزل أو إذا لم يكن لدى المستخدم أذونات، تنتهي عملية التفويض.

  5. يجب أن تظهر شاشة الجهاز متصل بعد ذلك، وتبدأ عملية الإعداد Matter. يمكن للمستخدم اختيار غرفة واسم جهاز في هذه الشاشة.

  6. تظهر شاشة جارٍ إعداد جهازك أثناء إضافة الجهاز إلى شبكة Matter.

  7. يستأنف تطبيقك التحكّم، ويتم تشغيل المفوّض المخصّص الآن، إذا كان مسجّلاً.

كيفية استخدام واجهة برمجة التطبيقات Commissioning API بصفتك مفوّض Matter ثانوي

تعرض هذه الخطوات عملية التفويض Matter التي تحدث فيها عملية التفويض قبل عملية التفويض من Google:

  1. يبدأ المستخدم عملية التفويض في تطبيقك. على سبيل المثال، ينقر المستخدم على إضافة جهاز.

  2. يتم تشغيل عملية تجربة المستخدم لتفويض الأجهزة لإضافة جهاز إلى شبكتك.

  3. بعد اكتمال العملية، يمكنك تحديد السلوك اللاحق استنادًا إلى معلوماتك عن المستخدم. على سبيل المثال، إذا كان المستخدم قد فعّل واجهات برمجة التطبيقات Google Home APIs، ما يشير على الأرجح إلى أنّ المستخدم يريد التفويض إلى Google، يمكنك بدء عملية التفويض.

  4. تستدعي عمليتك واجهة برمجة التطبيقات Commissioning API وتوفّر الحمولة التي تحتوي على رمز المرور والمميّز ومعلومات أخرى متاحة.

  5. تضيف عملية التفويض من Google الجهاز إلى شبكة Google.