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

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

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

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

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

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

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

المقوّمات الأساسية لعملية المشاركة

المكوّن	برامج	الوصف
واجهة Permissions API على Android	واجهات برمجة التطبيقات Home APIs للأذونات على Android	يطلب من المستخدمين منح أذونات لتطبيقك. قبل استخدام أي من واجهات برمجة التطبيقات Home API، يجب أن يحصل تطبيقك على إذن للوصول إلى الأجهزة في منزل المستخدم (يُشار إليه في واجهة برمجة التطبيقات باسم البنية). ومع ذلك، يعتمد ترتيب تنفيذ هذه الخطوة على سيناريو المطوّر، ويتم تضمينه في التنفيذ الفني.
الربط بين السحابة الإلكترونية والسحابة الإلكترونية	ربط الحسابات من خلال Cloud-to-cloud	تتيح لك هذه الميزة بدء عملية ربط الحساب لمشاركة الأجهزة المتصلة بالسحابة الإلكترونية مع Google Home من داخل تطبيقك. لتقليل الاحتكاك مع المستخدم، ننصحك باستخدام ميزة الرابط لصفحة معيّنة (المتاحة في كل من Android وiOS) التي تنقل المستخدمين مباشرةً إلى صفحة ربط الحساب المحدّدة في GHA.
واجهة Commissioning API على Android	تشغيل Matter	على الرغم من أنّ واجهة برمجة التطبيقات هذه تُستخدم بشكل عام لتشغيل أجهزة 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 باستخدام واجهات Cloud-to-cloud API

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

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

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

إذا كنت تنتج أجهزة متوافقة مع معيار Matter وأجهزة تتصل من السحابة الإلكترونية إلى السحابة الإلكترونية

1. نفِّذ عملية الربط العميقCloud-to-cloud.

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

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

3. استدعاء Commissioning API لنظام التشغيل Android على كل جهاز 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 خاصة بهم. يمكن أن تظهر نقطة الدخول للمستخدم مباشرةً بعد شاشة من نوع "تجربة الاستخدام الجاهزة"، حيث تكون مشاركة أجهزة Matter (من خلال Commissioning API) ومنح أذونات التطبيق (من خلال Permissions API) جزءًا من مسار تجربة المستخدم نفسه.

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

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

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