يمكن بدء عملية الإعداد في تطبيقك باستخدام Commissioning API بطريقتَين: إمّا مباشرةً في تطبيقك أو من خلال أداة اختيار التطبيقات في عملية "الإقران السريع". يغطّي هذا القسم تجربة المستخدم لكلتا الطريقتَين.
بدء عملية الإعداد من خلال التطبيق
في هذا السيناريو، يبدأ المستخدم عملية الإعداد في تطبيقك، وعادةً ما يكون ذلك من خلال عبارة تحث المستخدم على اتّخاذ إجراء (CTA) مثل "إضافة جهاز". ننصح بعرض الزر إضافة جهاز على النحو التالي:
- في المكان الذي يرى فيه المستخدمون جميع أجهزتهم، مثل صفحة عناصر التحكّم
- في المكان الذي يمكن للمستخدمين فيه إدارة المنزل، مثل صفحة الإعدادات
- في الصفحة الرئيسية لتطبيقك
عند اكتمال عملية الإعداد، ننصح بنقل المستخدم إلى الصفحة الرئيسية للتطبيق أو إلى مكان في التطبيق يعرض للمستخدم إمّا وحدة التحكّم بالجهاز التي تم إعدادها للتو أو يعرض قائمة كاملة بجميع الأجهزة، بما في ذلك الجهاز الذي تم إعداده للتو.
يوضّح الشكل 2 تجربة المستخدم:
ينقر مستخدم التطبيق على إضافة جهاز.
يمسح المستخدم رمز الاستجابة السريعة ضوئيًا أو يُدخل رمز الإقران.
يُطلب من المستخدم الموافقة على إضافة الجهاز إلى Google fabric (يتطابق ذلك مع "الموافقة + البيانات الوصفية" في الشكل 1) واختيار حساب Google الذي سيتم استخدامه.
إذا كان لدى المستخدم أكثر من منزل واحد، يُطلب منه اختيار منزل. إذا لم يكن لديه منزل تم إعداده، يتم تلقائيًا إنشاء منزل باسم "المنزل".
تربط Commissioning API بالجهاز.
يُطلب من المستخدم اختيار الغرفة التي يقع فيها الجهاز.
يُطلب من المستخدم إعادة تسمية الجهاز.
تنشئ Commissioning API Matter بيانات اعتماد، وتتحقّق من الاتصال بالشبكة، ثم تنفّذ عملية الإعداد، وتربط الجهاز بـ fabric الذي تم اختياره.
إذا تم منح الإذن بالوصول إلى بنية المستخدم و أجهزته، يجب أن يظهر الجهاز في المنزل مع الأجهزة الأخرى في ذلك المنزل، ويمكن التحكّم فيه باستخدام التطبيق.
إذا لم يتم منح الإذن بالوصول إلى بنية المستخدم و أجهزته بعد، لن يظهر الجهاز أو يمكن التحكّم فيه في التطبيق بعد. يجب الحصول على إذن للوصول إلى الجهاز والتحكّم فيه في أحد التطبيقات.
بدء عملية الإعداد من خلال "الإقران السريع"
يمكن أيضًا بدء عملية الإعداد باستخدام "الإقران السريع" على Android. بعد مسح رمز الاستجابة السريعة الخاص بالجهاز Matter، يُطلب من المستخدم اختيار تطبيق لمتابعة عملية الإعداد. يؤدي اختيار تطبيقك إلى استخدام Commissioning API من التطبيق، كما هو موضّح في الشكل 3.
إذا لم يكن التطبيق مثبّتًا على الجهاز الجوّال للمستخدم، يُطلب منه تثبيته قبل المتابعة. تكون تجربة المستخدم من شاشة الموافقة فصاعدًا هي نفسها الموضّحة في الشكل 2.
يُطلب من المستخدم مسح رمز استجابة سريعة ضوئيًا.
يمسح المستخدم رمز الاستجابة السريعة الخاص بالجهاز Matter ضوئيًا.
يُطلب من المستخدم اختيار تطبيق لمتابعة عملية الإعداد.
إذا لم يكن التطبيق مثبّتًا بعد، يُطلب من المستخدم تثبيته.
يتم تنزيل التطبيق من "متجر Google Play".
يتم تثبيت التطبيق.
بعد تثبيت التطبيق بنجاح، يُطلب من المستخدم المتابعة.
يُطلب من المستخدم الموافقة على إضافة الجهاز إلى Google fabric (يتطابق ذلك مع "الموافقة + البيانات الوصفية" في الشكل 1) واختيار حساب Google الذي سيتم استخدامه.
إذا كان لدى المستخدم أكثر من منزل واحد، يُطلب منه اختيار منزل. إذا لم يكن لديه منزل تم إعداده، يتم تلقائيًا إنشاء منزل باسم "المنزل".
تربط Commissioning API بالجهاز.
يُطلب من المستخدم اختيار الغرفة التي يقع فيها الجهاز.
يُطلب من المستخدم إعادة تسمية الجهاز.
تنشئ Commissioning API بيانات اعتماد Matter، وتتحقّق من الاتصال بالشبكة، ثم تنفّذ عملية الإعداد، وتربط الجهاز بـ fabric الذي تم اختياره.Matter
إذا تم منح الإذن بالوصول إلى بنية المستخدم وأجهزته بالفعل، يجب أن يظهر الجهاز في المنزل مع الأجهزة الأخرى في ذلك المنزل، ويمكن التحكّم فيه باستخدام التطبيق.
إذا لم يتم منح الإذن بالوصول إلى بنية المستخدم وأجهزته بعد، لن يظهر الجهاز أو يمكن التحكّم فيه في التطبيق بعد. يجب الحصول على إذن للوصول إلى الجهاز والتحكّم فيه في أحد التطبيقات.
أداة اختيار التطبيقات
هناك طريقتان لظهور تطبيقك في أداة اختيار التطبيقات أثناء عملية الإعداد:
- على شاشة اختيار تطبيق
- إذا اختار المستخدمون اختيار تطبيق آخر، سيظهر التطبيق على شاشة التطبيقات الأخرى المثبّتة.
التطبيقات المقترَحة
تعرض أداة اختيار التطبيقات تطبيقَين مقترَحَين.
- الأول هو دائمًا Google Home app (GHA).
- الثاني هو التطبيق المفضّل لصانع الجهاز، إذا تم تحديده في مشروع
Google Home Developer Console المرتبط برقم تعريف المورّد (VID) أو رقم تعريف المنتج (PID) للجهاز. (لا ينطبق هذا الخيار على مطوّري التطبيقات الذين لا يصنعون أجهزة Matter.)
هناك سيناريوهان عندما تكون التطبيقات على شاشة اختيار تطبيق.
- مثبّت : Google Play services تتحقّق من أنّ التطبيق يتيح
فلتر الغرض
ACTION_COMMISSION_DEVICE. إذا كان فلتر الغرض غير متوفّر، يتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق. - غير مثبّت : يتم توجيه المستخدم إلى "متجر Play" لتثبيت التطبيق قبل المتابعة.