تفعيل تجربة المستخدم على Android

يمكن بدء عملية التفعيل في تطبيقك باستخدام واجهة برمجة التطبيقات Commissioning API بطريقتَين: مباشرةً في تطبيقك أو من خلال أداة اختيار التطبيقات في عملية الربط السريع. يتناول هذا القسم تجربة المستخدم لكل منها.

بدأها التطبيق

في هذا السيناريو، يبدأ المستخدم عملية الإعداد في تطبيقك، ويحدث ذلك عادةً من خلال عبارة تحثّ المستخدم على اتّخاذ إجراء بعنوان "إضافة جهاز". ننصحك بعرض زر إضافة جهاز على النحو التالي:

  • حيث يرى المستخدمون جميع أجهزتهم، مثل صفحة عناصر التحكّم
  • المكان الذي يمكن للمستخدمين من خلاله إدارة المنزل، مثل صفحة الإعدادات
  • صفحة الصفحة الرئيسية في تطبيقك

عند اكتمال عملية الإعداد، ننصحك بتوجيه المستخدم إلى الصفحة الرئيسية للتطبيق أو إلى مكان في التطبيق يعرض للمستخدم وحدة التحكّم بالجهاز التي تم إعدادها للتو أو يعرض قائمة كاملة بجميع الأجهزة، بما في ذلك الجهاز الذي تم إعداده للتو.

يتم توضيح تجربة المستخدم في الشكل 2:

  • تفعيل التطبيق (الخطوة 1)

    ينقر مستخدم التطبيق على إضافة جهاز.

  • تفعيل التطبيق (الخطوة 2)

    يمسح المستخدم رمز الاستجابة السريعة ضوئيًا أو يُدخِل رمز الإقران.

  • تفعيل الجهاز من خلال التطبيق (الخطوة 3)

    يُطلب من المستخدم الموافقة على إضافة الجهاز إلى Google Fabric (يتوافق ذلك مع "الموافقة + البيانات الوصفية" في الشكل 1) واختيار حساب Google المطلوب استخدامه.

  • تفعيل التطبيق (الخطوة 4)

    إذا كان لدى المستخدم أكثر من منزل واحد، سيُطلب منه اختيار منزل. إذا لم يكن لدى المستخدم منزل تم إعداده، سيتم إنشاء منزل باسم "المنزل" تلقائيًا.

  • تفعيل الجهاز من خلال التطبيق (الخطوة 5)

    تتصل واجهة برمجة التطبيقات Commissioning API بالجهاز.

  • تفعيل التطبيق (الخطوة 6)

    يُطلَب من المستخدم اختيار الغرفة التي يوجد فيها الجهاز.

  • تفعيل التطبيق (الخطوة 8)

    يُطلَب من المستخدم إعادة تسمية الجهاز.

  • تفعيل التطبيق (الخطوة 10)

    تُنشئ واجهة برمجة التطبيقات Commissioning API ملفًا شخصيًا لتسجيل الدخول إلى Matter، وتتحقّق من إمكانية الاتصال بالشبكة، ثمّ تُنفِّذ عملية الإعداد، وتربط الجهاز بالبنية التي تم اختيارها.

  • تفعيل الإصدار من خلال التطبيق (الخطوة 11)

    إذا سبق أن تم منح الإذن بالوصول إلى بنية المستخدم وأجهزته، من المفترض أن يظهر الجهاز في "المنزل" مع الأجهزة الأخرى في ذلك "المنزل"، ويمكن التحكّم فيه باستخدام التطبيق.

    إذا لم يتم منح الإذن بالوصول إلى بنية المستخدم وأجهزته، من المفترض ألا يظهر الجهاز أو يمكن التحكّم فيه في التطبيق بعد. يلزم الحصول على إذن للوصول إلى الجهاز والتحكّم فيه في أحد التطبيقات.

الشكل 2: التفويض الذي يبدأه التطبيق

بدأت عملية الإقران من خلال ميزة "الإقران السريع".

يمكن أيضًا بدء عملية الإعداد باستخدام ميزة "الإقران السريع" في Android. بعد مسح رمز الاستجابة السريعةMatter للجهاز ضوئيًا، سيُطلَب من المستخدم اختيار تطبيق لمواصلة عملية الإعداد. عند اختيار تطبيقك، يتم استخدام واجهة برمجة التطبيقات Commissioning API من التطبيق، كما هو موضّح في الشكل 3.

إذا لم يكن التطبيق مثبّتًا على جهاز المستخدم الجوّال، تتم مطالبته بتثبيته قبل المتابعة. تكون تجربة المستخدم من شاشة طلب الموافقة وما بعد مماثلة لتلك الواردة في الشكل 2.

  • إعداد ميزة "الإقران السريع" (الخطوة 1)

    يُطلب من المستخدم مسح رمز الاستجابة السريعة ضوئيًا.

  • إعداد ميزة "الإقران السريع" (الخطوة 2)

    يمسح المستخدم ضوئيًا رمز الاستجابة السريعة Matter للجهاز.

  • إعداد ميزة "الإقران السريع" (الخطوة 3)

    يُطلَب من المستخدم اختيار تطبيق ل مواصلة عملية التفعيل.

  • إعداد ميزة "الإقران السريع" (الخطوة 4)

    إذا لم يكن التطبيق مثبّتًا، يُطلَب من المستخدم تثبيته.

  • تفعيل ميزة "الإقران السريع" (الخطوة 5)

    يتم تنزيل التطبيق من "متجر Google Play".

  • إعداد ميزة "الإقران السريع" (الخطوة 6)

    تم تثبيت التطبيق.

  • إعداد ميزة "الإقران السريع" (الخطوة 7)

    بعد تثبيت التطبيق بنجاح، سيُطلب من المستخدم المتابعة.

  • إعداد ميزة "الإقران السريع" (الخطوة 8)

    يُطلب من المستخدم الموافقة على إضافة الجهاز إلى Google Fabric (يتوافق ذلك مع "الموافقة + البيانات الوصفية" في الشكل 1) واختيار حساب Google المطلوب استخدامه.

  • إعداد ميزة "الإقران السريع" (الخطوة 9)

    إذا كان لدى المستخدم أكثر من منزل واحد، سيُطلب منه اختيار منزل. إذا لم يكن لدى المستخدم منزل تم إعداده، سيتم إنشاء منزل باسم "المنزل" تلقائيًا.

  • تفعيل ميزة "الإقران السريع" (الخطوة 10)

    تتصل واجهة برمجة التطبيقات Commissioning API بالجهاز.

  • إعداد ميزة "الإقران السريع" (الخطوة 11)

    يُطلَب من المستخدم اختيار الغرفة التي يوجد فيها الجهاز.

  • تفعيل ميزة "الإقران السريع" (الخطوة 13)

    يُطلَب من المستخدم إعادة تسمية الجهاز.

  • تفعيل ميزة "الإقران السريع" (الخطوة 15)

    تُنشئ واجهة برمجة التطبيقات Commissioning API بيانات اعتماد Matter ، وتتحقّق من إمكانية الاتصال بالشبكة، ثم تنفِّذ عملية الإعداد ، وتربط الجهاز بالشبكة المختارة.

  • تفعيل ميزة "الإقران السريع" (الخطوة 16)

    إذا سبق أن تم منح الإذن بالوصول إلى بنية المستخدم وأجهزته ، من المفترض أن يظهر الجهاز في "المنزل" مع الأجهزة الأخرى في ذلك "المنزل"، ويمكن التحكّم فيه باستخدام التطبيق.

    إذا لم يتم منح الإذن بالوصول إلى بنية المستخدم وأجهزةه بعد، من المفترض ألا يظهر الجهاز أو يمكن التحكّم فيه في التطبيق بعد. يلزم الحصول على الإذن لأجل الوصول إلى الجهاز والتحكّم فيه في أحد التطبيقات.

الشكل 3: إعداد ميزة "الإقران السريع"

أداة اختيار التطبيقات

عرض لأداة اختيار التطبيقات تعرض تطبيقَين للاختيار من بينهما

هناك طريقتان لظهور تطبيقك في أداة اختيار التطبيقات أثناء عملية الإعداد:

  1. على شاشة اختيار تطبيق
  2. إذا اختار المستخدمون اختيار تطبيق آخر، سيظهر على شاشة التطبيقات المُثبَّتة الأخرى.

التطبيقات المقترَحة

تعرض أداة اختيار التطبيقات تطبيقَين مقترَحين.

  • القيمة الأولى هي Google Home app (GHA) دائمًا.
  • أما الخيار الثاني، فهو مخصّص للتطبيق المفضّل لصانع الجهاز، إذا تم تحديده في أحد مشاريع Google Home Developer Console المرتبطة بمعرّف VID أو معرّف PID للجهاز. (لا ينطبق هذا الخيار على مطوّري التطبيقات الذين لا يطوّرون تطبيقات لأجهزة Matter). تطبيق المفوّض المفضّل للشركة المصنّعة للجهاز

هناك سيناريوهان عندما تكون التطبيقات على شاشة اختيار تطبيق.

  1. مثبَّت: Google Play services تأكَّد من أنّ التطبيق متوافق مع فلتر الغرض ACTION_COMMISSION_DEVICE. إذا لم يكن فلتر الأهداف متوفّرًا، سيتم توجيه المستخدم إلى "متجر Play" لتحديث التطبيق.
  2. غير مثبَّت: يتم توجيه المستخدم إلى "متجر Play" لتثبيت التطبيق قبل المتابعة.