يقدّم هذا الدليل إرشادات بشأن تجربة المستخدم لتصميم أذونات الأجهزة ومشاركتها بشكل سلس في واجهات برمجة تطبيقات 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 | على الرغم من أنّ هذه الواجهة تُستخدَم بشكل عام لتفعيل أجهزة جديدة، يمكنك أيضًا استخدامها لإضافة شبكة Google إلى الأجهزة التي تم تفعيلها مسبقًا على شبكة أخرى.MatterMatter لذلك، تُعدّ هذه الأداة مفيدة في عملية الإعداد. |
التنفيذ الفني
تعتمد طريقة إنشاء مسارات المشاركة على الأجهزة التي تخطّط لمشاركتها مع Google.
في الحالات التالية، ننصحك باتّباع الخطوات بالترتيب المحدّد. يساعد ذلك في توفير تجربة أفضل للمستخدمين بشكل عام.
أنت تصنّع أجهزة متوافقة مع معيار Matter فقط
أن تصنّع أجهزة متوافقة مع معيار Matter وتريد إعدادها في Google Home
استدعاء Permissions API على Android
استدعِ Commissioning API على Android على كل جهاز Matter تم إعداده مسبقًا على شبكة أخرى.
- بما أنّه يجب إجراء مشاركة Matter لكل جهاز على حدة، وهناك العديد من الشاشات التي تتطلّب إدخال بيانات من المستخدم، ننصحك بتوجيه المستخدم خلال هذه العملية من خلال:
- تزويد المستخدمين بقائمة بأجهزة Matter التي لا تتم مشاركتها مع Google
- السماح للمستخدمين ببدء عملية مشاركة الجهاز (باستخدام Commissioning API) من خلال النقر على الأجهزة في تلك القائمة
- الرجوع إلى قائمة أجهزة Matter، مع عرض حالة تقدّم المهمة وحالة المشاركة للمستخدم
- بما أنّه يجب إجراء مشاركة Matter لكل جهاز على حدة، وهناك العديد من الشاشات التي تتطلّب إدخال بيانات من المستخدم، ننصحك بتوجيه المستخدم خلال هذه العملية من خلال:
أنّك لا تصنّع سوى الأجهزة التي تتم مشاركتها مع Google باستخدام واجهات Cloud-to-cloud API
تنفيذ Cloud-to-cloud الربط بصفحة معيّنة يؤدي ذلك إلى إضافة الأجهزة إلى قاعدة بيانات Home Graph من Google.
- ننصحك بإجراء عملية Cloud-to-cloud الربط أولاً لتجنُّب حدوث مواقف مربكة محتملة، مثل عرض قائمة على المستخدم تتضمّن أجهزة تتم مشاركتها مع Google وأجهزة لا تتم مشاركتها مع Google.
استدعاء Permissions API على Android
تنتج أجهزة متوافقة مع Cloud-to-cloud وMatter
تنفيذ Cloud-to-cloud الربط بصفحة معيّنة
- ننصحك بإجراء عملية Cloud-to-cloud الربط أولاً لتجنُّب حدوث مواقف مربكة محتملة، مثل عرض قائمة على المستخدم تتضمّن أجهزة تتم مشاركتها مع Google وأجهزة لا تتم مشاركتها مع Google.
استدعاء Permissions API على Android
استدعِ Commissioning API for Android على كل جهاز Matter تم إعداده مسبقًا على شبكة أخرى.
- بما أنّه يجب إجراء مشاركة Matter لكل جهاز على حدة، وهناك العديد من الشاشات التي تتطلّب إدخال بيانات من المستخدم، ننصحك بتوجيه المستخدم خلال هذه العملية من خلال:
- تزويد المستخدمين بقائمة بأجهزة Matter التي لا تتم مشاركتها مع Google
- السماح للمستخدمين ببدء عملية مشاركة الجهاز (باستخدام Commissioning API) من خلال النقر على الأجهزة في تلك القائمة
- الرجوع إلى قائمة أجهزة Matter، مع عرض حالة تقدّم المهمة وحالة المشاركة للمستخدم
- بما أنّه يجب إجراء مشاركة 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.
اقتراحات المحتوى
يسهل على المستخدمين الوثوق بشيء يفهمونه ويضيف قيمة. تمكين المستخدمين من خلال تقديم معلومات تساعدهم على اتّخاذ قرارات مدروسة، بما في ذلك المفاضلة بين الخيارات
الدرجة الصوتية الحرجة
لن يواصل المستخدمون مشاركة الأجهزة إذا لم يكن هناك عرض قيمة قوي للقيام بذلك.
- أولِ اهتمامًا خاصًا بطريقة عرض المنتج أو الخدمة.
- اجعلها جذابة ولكن لا تبالغ في الوعود.
- إذا كان المستخدم بحاجة إلى جهاز مذكور في أغنيتك الترويجية، احرص على توضيح ذلك بشكل كامل حتى لا يواجه أي عائق غير متوقّع.
- قد تتوفّر لك فرصة واحدة فقط لاكتساب هؤلاء المستخدمين، لذا احرص على الاستفادة منها.
أفضل الممارسات
- ابدأ من وجهة نظر المستخدم، أي من خلال التركيز على الفوائد التي سيحصل عليها.
- لا تكتب أكثر من أربعة أسطر من المحتوى في قسم واحد. قد يؤدي استخدام عدد كبير من الكلمات إلى فقدان انتباه المستخدم. مع ذلك، قد يكون الوضوح والفهم أكثر أهمية من الإيجاز.
- العمليات المبرمَجة ممتعة! اختَر مثالاً مثيرًا للاهتمام ومفيدًا إذا سمحت المساحة بذلك.
- حاوِل استخدام أسلوب مرح إذا كان ذلك يتوافق مع استراتيجيتك الشاملة.
- استخدِم عبارات تحثّ على اتّخاذ إجراء، مثل "البدء".