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

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

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

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

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

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

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

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

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

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

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

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

إذا كنت تنتج أجهزة متوافقة مع معيار Matter فقط

أنت تنتج أجهزة متوافقة مع معيار Matter وتريد تفعيلها على Google Home.

1. استدعاء Permissions API

2. استخدِم واجهة برمجة التطبيقات Google Commissioning API على كل جهاز Matter تم تفعيله سابقًا في بنية أخرى.

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

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

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

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

2. استدعاء Permissions API

أنت تنتج كلاً من أجهزة "السحابة الإلكترونية للسحابة الإلكترونية" وأجهزة Matter

1. يمكنك إجراء Cloud-to-cloud ربط بصفحة في التطبيق.

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

2. استدعاء Permissions API

3. استخدِم واجهة برمجة التطبيقات Google Commissioning API على كل جهاز Matter تم تفعيله سابقًا في بنية أخرى.

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

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

استدعاء Permissions API

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

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

مكان تقديم ميزة "مشاركة الأجهزة" في التطبيق

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

ولا تكون هذه العناصر متعارضة أيضًا، وهناك نقاط إدخال متعددة:

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

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

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

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

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

من مرحلة الإعداد فقط

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

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

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

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

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

اقتراحات التصميم المرئي

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

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

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

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

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

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

القيمة الحرجة

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

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

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

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