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