مسارات إعداد المستخدم النهائي على Android

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

المواضيع الرئيسية الموضّحة هنا هي:

• لماذا يجب مشاركة الأجهزة مع Google Home؟
• المراحل الرئيسية لعملية المشاركة
• التنفيذ الفني
• أفضل الممارسات المتعلّقة بتجربة المستخدم

لماذا يجب مشاركة الأجهزة مع Google Home؟

للاستفادة من الإمكانات التي توفّرها واجهات برمجة تطبيقات Home، على المستخدمين مشاركة أجهزتهم مع Google Home للأسباب التالية:

• هذا شرط فني لكي تستخدم Google هذه الأجهزة في عمليات التشغيل الآلي.
• ويساعد ذلك في الحفاظ على تجربة متسقة ومرنة على Google Home.
  • من الضروري عرض الأجهزة بشكل متّسق في جميع التطبيقات المتوافقة مع Home API لتجنُّب إنشاء تجربة مستخدم مجزّأة ومربكة، حيث يضطر المستخدمون إلى التبديل بين التطبيقات لإنجاز المهام الأساسية.

المكوّنات الرئيسية لعملية المشاركة

المكوّن	برامج	الوصف
واجهة Permissions API على Android	واجهات برمجة التطبيقات الخاصة بالشاشة الرئيسية للحصول على الأذونات على Android	يطلب من المستخدمين منح الأذونات لتطبيقك. قبل استخدام أي من واجهات برمجة التطبيقات Home، يجب أن يكون تطبيقك لديه إذن بالوصول إلى الأجهزة في منزل المستخدم (يُشار إليه في واجهة برمجة التطبيقات باسم البنية). ومع ذلك، يعتمد ترتيب تنفيذ هذه الخطوة على سيناريو المطوّر، ويتم تضمينها في التنفيذ الفني.
الربط من السحابة الإلكترونية إلى السحابة الإلكترونية	ربط الحسابات من خلال السحابة الإلكترونية	تتيح لك بدء عملية ربط الحساب لمشاركة الأجهزة المتصلة بالسحابة الإلكترونية مع Google Home من داخل تطبيقك. ولتقليل المشاكل التي قد يواجهها المستخدمون، ننصحك باستخدام ميزة الروابط لصفحات معيّنة (المتاحة على كلّ من Android وiOS) التي تنقل المستخدمين مباشرةً إلى صفحة ربط الحساب المحدّدة في تطبيق Google Home.
Commissioning API على Android	Matter Commissioning	على الرغم من أنّ هذه الواجهة تُستخدَم بشكل عام لتفعيل أجهزة Matter جديدة، يمكنك أيضًا استخدامها لإضافة شبكة Google إلى أجهزة Matter سبق أن تم تفعيلها على شبكة أخرى. وبالتالي، تُعدّ هذه الواجهة أداة مفيدة في عملية الإعداد.

التنفيذ الفني

تعتمد طريقة إنشاء مسارات المشاركة على الأجهزة التي تخطّط للمشاركة مع Google.

في الحالات التالية، ننصحك باتّباع الخطوات بالترتيب المحدّد، ما يساعد في تقديم تجربة أفضل للمستخدمين بشكل عام.

أنّك تنتج أجهزة متوافقة مع Matter فقط

أن تصنّع أجهزة متوافقة مع معيار Matter وتريد إعدادها في Google Home

1. استدعاء Permissions API على Android

2. استدعِ Commissioning API على Android على كل جهاز Matter تم إعداده مسبقًا على شبكة أخرى.

   1. بما أنّه يجب تنفيذ عملية مشاركة Matter لكل جهاز على حدة، وبما أنّ هناك العديد من الشاشات التي تتطلّب إدخال بيانات من المستخدم، ننصحك بتوجيه المستخدم خلال هذه العملية من خلال:
      • تزويد المستخدمين بقائمة بأجهزة Matter التي لا تتم مشاركتها مع Google
      • السماح للمستخدمين ببدء عملية مشاركة الجهاز (باستخدام Commissioning API) من خلال النقر على الأجهزة في تلك القائمة
      • الرجوع إلى قائمة أجهزة Matter، مع عرض مستوى تقدّم المهمة وحالة المشاركة للمستخدم

أنت تنتج فقط الأجهزة التي تتم مشاركتها مع Google باستخدام واجهات برمجة التطبيقات من السحابة إلى السحابة

1. تنفيذ Cloud-to-cloud الربط بصفحة معيّنة يؤدي ذلك إلى إضافة الأجهزة إلى مخطط Google Home.

   1. ننصحك بإجراء عملية الربط Cloud-to-cloud أولاً لتجنُّب المواقف التي قد تسبب إرباكًا، مثل عرض قائمة على المستخدم تتضمّن أجهزة تتم مشاركتها مع Google وأجهزة لا تتم مشاركتها مع Google.

2. استدعاء Permissions API على Android

أنّك تنتج أجهزة متوافقة مع Cloud-to-cloud وMatter

1. تنفيذ Cloud-to-cloud الربط بصفحة معيّنة

   1. ننصحك بإجراء عملية الربط Cloud-to-cloud أولاً لتجنُّب المواقف التي قد تسبب إرباكًا، مثل عرض قائمة على المستخدم تتضمّن أجهزة تتم مشاركتها مع Google وأجهزة لا تتم مشاركتها مع Google.

2. استدعاء Permissions API على Android

3. استدعِ Commissioning API for Android على كل جهاز Matter تم إعداده مسبقًا على شبكة منزلية أخرى.

   1. بما أنّه يجب تنفيذ عملية مشاركة Matter لكل جهاز على حدة، وبما أنّ هناك العديد من الشاشات التي تتطلّب إدخال بيانات من المستخدم، ننصحك بتوجيه المستخدم خلال هذه العملية من خلال:
      • تزويد المستخدمين بقائمة بأجهزة Matter التي لا تتم مشاركتها مع Google
      • السماح للمستخدمين ببدء عملية مشاركة الجهاز (باستخدام Commissioning API) من خلال النقر على الأجهزة في تلك القائمة
      • الرجوع إلى قائمة أجهزة Matter، مع عرض مستوى تقدّم المهمة وحالة المشاركة للمستخدم

ليس لديك أي أجهزة لمشاركتها مع Google

استدعاء Permissions API

أفضل الممارسات المتعلّقة بتجربة المستخدم

يحتوي هذا القسم على بعض رحلات المستخدمين المهمة التي يجب أخذها في الاعتبار عند تطوير تطبيق يستفيد من واجهات برمجة التطبيقات Home.

مواضع عرض ميزة مشاركة الجهاز في التطبيق

هذه القائمة ليست شاملة، وقد تجد فرصًا أخرى لتوفير تجربة مشاركة وعرض Google Home في الوقت المناسب للمستخدمين.

ولا يستبعد بعضها بعضًا، وتتوفّر نقاط دخول متعددة:

من قائمة "الإعدادات"

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

قد تحتاج إلى فصل مشاركة الجهاز (Cloud-to-cloud الربط وMatter واجهة برمجة التطبيقات Commissioning API) عن أذونات التطبيق (واجهة برمجة التطبيقات Permissions API)، ما يتيح للمستخدمين التحكّم في الخطوات التي يكملونها، كما يوفّر لك فرصة لعرض حالة الاتصال للمستخدم.

عند استخدام الأجهزة في عمليات التشغيل الآلي التي تديرها Google

من علامة التبويب "عمليات التشغيل الآلي"، يمكن للمستخدمين النقر على نقطة دخول إلى مسار المشاركة، وقراءة شاشة عرض القيمة التي توضّح بوضوح مزايا المتابعة، ثم الانتقال بسرعة خلال مسار الأذونات.

من عملية الإعداد فقط

ينطبق هذا السيناريو بشكل أساسي على الشركاء الذين ينتجون أجهزة متوافقة مع Matter فقط (بدون أجهزة Cloud-to-cloud) وليس لديهم Matter خاص بهم. يمكن أن تكون نقطة دخول المستخدم مباشرةً بعد شاشة من النوع الجاهز للاستخدام، حيث تكون مشاركة أجهزة Matter (عبر Commissioning API) ومنح أذونات التطبيق (عبر Permissions API) جزءًا من مسار تجربة المستخدم نفسه.

منطق المشاركة

في ما يلي بعض الاقتراحات بشأن طلبات المستخدمين:

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

• قد يتشارك عدة مشرفين في Google Home بنية المنزل في Google Home، وفي بعض الحالات، قد يتم استخدام حساب واحد فقط لمشاركة الأجهزة مع Google. نتيجةً لذلك، لن يكون إكمال عملية ربط Cloud-to-cloud شرطًا أساسيًا لطلب أذونات Home APIs.

اقتراحات بشأن التصميم المرئي

• يجب أن تتضمّن وصفًا واضحًا للمزايا التي ستحصل عليها عند إعداد Google Home (مثلاً، "إنشاء عمليات تشغيل آلي متقدّمة باستخدام Google Home" أو "التحكّم في الأجهزة باستخدام التطبيقات التي تختارها").

• عبارة تحث المستخدم على اتخاذ إجراء (مثل "البدء") وطريقة لإلغاء العملية إذا لم يرِد المستخدم مواصلتها

• إذا توفّرت مساحة، يمكنك تقديم شرح لما سيحدث أثناء انتقال المستخدم بين الشاشات.

• بالنسبة إلى Matter تحديدًا، إذا سبق أن منح المستخدم إذن الوصول إلى منزله من خلال واجهات برمجة التطبيقات Home، يمكنك إتاحة مشاركة الأجهزة في منزله مع Google Home عند إعداد أجهزة جديدة. على سبيل المثال، يمكنك إضافة جهاز Matter إلى شبكتك ثم مطالبة المستخدم بإضافة هذا الجهاز إلى شبكة Google.

اقتراحات المحتوى

يسهل على المستخدمين الوثوق بشيء يفهمونه ويضيف قيمة. تمكين المستخدمين من خلال تقديم معلومات تساعدهم على اتّخاذ قرارات مدروسة، بما في ذلك المفاضلة بين الخيارات

الدرجة الصوتية الحرجة

لن يواصل المستخدمون مشاركة الأجهزة إذا لم يكن هناك عرض قيمة قوي للقيام بذلك.

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

أفضل الممارسات

1. ابدأ من وجهة نظر المستخدم، أي من خلال التركيز على الفائدة التي سيحصل عليها.
2. لا تكتب أكثر من أربعة أسطر من المحتوى في قسم واحد، لأنّ كثرة الكلمات قد تفقد المستخدم تركيزه، ولكن الوضوح والفهم قد يكونان أهم من الإيجاز.
3. العمليات المبرمَجة ممتعة، لذا اختَر مثالاً مثيرًا للاهتمام ومفيدًا إذا سمحت المساحة بذلك.
4. حاوِل استخدام أسلوب مرح إذا كان ذلك يتوافق مع استراتيجيتك العامة.
5. استخدِم عبارات تحثّ على اتّخاذ إجراء، مثل "البدء".