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

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

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

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

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

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

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

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

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

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

تعتمد طريقة إنشاء مسارات المشاركة على الأجهزة التي تخطّط للمشاركة مع 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 API، يمكنك إتاحة مشاركة الأجهزة في منزله مع Google Home عند إعداد أجهزة جديدة. على سبيل المثال، يمكنك إضافة Matterجهاز إلى شبكتك ثم مطالبة المستخدم بإضافة هذا الجهاز إلى شبكة Google.

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

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

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

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

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

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

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