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