تتيح واجهة برمجة التطبيقات Commissioning API على Android إمكانية إدارة أجهزة Matter من قِبل عدة مشرفين (أو عدة مشرفين) لـ 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
يبدأ المستخدم عملية التفويض في التطبيق. على سبيل المثال، ينقر المستخدم على زر يحمل اسم إضافة جهاز.
تتولى تجربة المستخدم من Google عملية التحكم وتعرض شاشة مسح رمز الاستجابة السريعة، ما يسمح للمستخدم بمسح رمز الاستجابة السريعة ضوئيًا لبدء عملية الإعداد.Matter
في شاشة ربط هذا الجهاز بحسابك على Google ، ينقر المستخدم على أوافق لإضافة جهاز إلى منظومة Google المتكاملة. إذا نقر المستخدم بدلاً من ذلك على إلغاء في هذه الشاشة، تنتهي جميع عمليات تفويض الأجهزة على الفور.
في شاشة اختيار منزل ، يختار المستخدم المنزل الذي يمكنه من خلاله التحكّم في الجهاز. إذا لم يكن هناك منزل متاح، يتم إنشاء منزل جديد. إذا لم يتم العثور على أي مراكز مناسبة في المنزل، أو إذا لم يكن لدى المستخدم أذونات، تنتهي عملية التفويض.
يجب أن تظهر شاشة الجهاز متصل بعد ذلك، وتبدأ عملية الإعداد Matter. يمكن للمستخدم اختيار غرفة واسم جهاز في هذه الشاشة.
تظهر شاشة جارٍ إعداد جهازك أثناء إعداد الجهاز على شبكة Matter fabric.
يستأنف تطبيقك التحكّم، ويتم تشغيل المفوّض المخصّص الآن، إذا كان مسجّلاً.
كيفية استخدام واجهة برمجة التطبيقات Commissioning API بصفتك مفوّض Matter ثانوي
تعرض هذه الخطوات عملية Matter التفويض حيث تحدث عملية التفويض قبل عملية التفويض من Google:
يبدأ المستخدم عملية التفويض في تطبيقك. على سبيل المثال، ينقر المستخدم على إضافة جهاز.
يتم تشغيل عملية تجربة مستخدم التفويض لإضافة جهاز إلى شبكتك.
بعد اكتمال العملية، يمكنك تحديد السلوك اللاحق استنادًا إلى معلوماتك عن المستخدم. على سبيل المثال، إذا كان المستخدم قد فعّل واجهات برمجة التطبيقات Google Home APIs، ما يشير على الأرجح إلى أنّ المستخدم يريد التفويض إلى Google، يمكنك بدء عملية التفويض.
تستدعي عمليتك واجهة برمجة التطبيقات Commissioning API وتوفّر الحمولة التي تحتوي على رمز المرور والمميّز ومعلومات أخرى متاحة.
تضيف عملية التفويض من Google الجهاز إلى شبكة Google.