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