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