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