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

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

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

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

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

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

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

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

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

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

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

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

أنت تنتج أجهزة Matter فقط

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

1. استخدِم Permissions API على Android.

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

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

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

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 تم إعداده مسبقًا على fabric آخر.

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

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

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

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

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

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

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

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

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

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

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

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

العرض الترويجي المهم

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

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

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

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