תהליכי ההצטרפות של משתמשי קצה ב-Android

במדריך הזה מוסבר איך לעצב את חוויית המשתמש של הרשאות המכשיר ושיתוף המידע ב-API של Google Home, כדי ליצור תהליך חלק של צירוף משתמשים לאפליקציה.

הנושאים העיקריים שמתוארים כאן הם:

• למה כדאי לשתף מכשירים עם Google Home?
• השלבים העיקריים בתהליך השיתוף
• הטמעה טכנית
• שיטות מומלצות לחוויית משתמש

למה כדאי לשתף מכשירים עם Google Home?

כדי ליהנות מהיכולות של ממשקי ה-API של Home, המשתמשים צריכים לשתף את המכשירים שלהם עם Google Home כי:

• זו דרישה טכנית של Google כדי להשתמש במכשירים האלה באוטומציות.
• כך אפשר לשמור על חוויית שימוש עקבית וגמישה ב-Google Home.
  • חשוב לוודא שהמכשירים מוצגים באופן עקבי באפליקציות שמופעל בהן Home API, כדי למנוע חוויית משתמש מפוצלת ומבלבלת שבה המשתמשים צריכים לעבור בין אפליקציות כדי לבצע משימות בסיסיות.

הרכיבים העיקריים של תהליך השיתוף

רכיב	תוכנית	תיאור
‫Permissions API ב-Android	ממשקי API של Home להרשאות ב-Android	ההרשאה הזו מציגה למשתמשים בקשות להענקת הרשאות לאפליקציה. כדי להשתמש באחד מממשקי ה-API של Home, האפליקציה צריכה לקבל הרשאה לגשת למכשירים בבית של המשתמש (שנקראים ב-API מבנה). עם זאת, הסדר שבו מבצעים את השלב הזה תלוי בתרחיש של המפתח, והוא מפורט במאמר הטמעה טכנית.
קישור מענן לענן	קישור חשבונות בענן	האפשרות הזו מאפשרת להתחיל את תהליך קישור החשבון כדי לשתף מכשירים שמחוברים לענן עם Google Home מתוך האפליקציה. כדי לצמצם את החיכוך עם המשתמשים, מומלץ להשתמש ביכולת של קישורי עומק (שזמינה גם ב-Android וגם ב-iOS) שמעבירה את המשתמשים ישירות לדף הספציפי של קישור החשבון ב-GHA.
Commissioning API on Android	הפעלת Matter	בדרך כלל חושבים על API ככלי להפעלת מכשירים חדשים, אבל אפשר להשתמש בו גם כדי להוסיף את Google Fabric למכשירים שכבר הופעלו ב-Fabric אחר.MatterMatter לכן, זהו כלי שימושי לתהליך ההצטרפות.

הטמעה טכנית

אופן יצירת תהליכי השיתוף תלוי במכשירים שאתם מתכננים לשתף עם Google.

בתרחישים הבאים, מומלץ לפעול לפי השלבים בסדר שבו הם מופיעים. כך אפשר לספק למשתמשים חוויה טובה יותר באופן כללי.

אתם מייצרים רק מכשירים בתקן Matter

אתם מייצרים מכשירים שתואמים לתקן Matter ואתם רוצים להוסיף אותם ל-Google Home.

1. קוראים ל-Permissions API ב-Android.

2. מתקשרים אל Commissioning API ב-Android בכל מכשיר Matter שהופעל בעבר ברשת אחרת.

   1. מכיוון שצריך לבצע את השיתוף Matterבכל מכשיר בנפרד, ויש הרבה מסכים שדורשים קלט מהמשתמש, מומלץ להנחות את המשתמש בתהליך הזה באמצעות הפעולות הבאות:
      • אספקת רשימה של מכשירי Matter שלא משותפים עם Google למשתמשים.
      • לאפשר למשתמשים להתחיל את תהליך שיתוף המכשיר (באמצעות Commissioning API) על ידי לחיצה על מכשירים ברשימה.
      • חוזרים לרשימת מכשירי Matter, שבה מוצג למשתמש סטטוס השיתוף והתקדמות המשימה.

אתם מייצרים רק מכשירים שמשותפים עם Google באמצעות ממשקי API של Cloud-to-cloud

1. מבצעים Cloud-to-cloud קישורי עומק. המכשירים יתווספו לגרף Google Home.

   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 for Android בכל מכשיר Matter שהוקצה בעבר לרשת אחרת.

   1. מכיוון שצריך לבצע את השיתוף Matterבכל מכשיר בנפרד, ויש הרבה מסכים שדורשים קלט מהמשתמש, מומלץ להנחות את המשתמש בתהליך הזה באמצעות הפעולות הבאות:
      • אספקת רשימה של מכשירי Matter שלא משותפים עם Google למשתמשים.
      • לאפשר למשתמשים להתחיל את תהליך שיתוף המכשיר (באמצעות Commissioning API) על ידי לחיצה על מכשירים ברשימה.
      • חוזרים לרשימת מכשירי Matter, שבה מוצג למשתמש סטטוס השיתוף והתקדמות המשימה.

אין לך מכשירים שאפשר לשתף עם Google

שולחים קריאה ל-Permissions API.

שיטות מומלצות ל-UX

בקטע הזה מפורטים כמה מסלולי משתמש קריטיים שכדאי לקחת בחשבון כשמפתחים אפליקציה שמבוססת על ממשקי Home API.

איפה כדאי להציג את שיתוף המכשירים באפליקציה

זו רשימה חלקית בלבד, ויכול להיות שתמצאו הזדמנויות נוספות להציע למשתמשים שלכם חוויית שיתוף ושימוש ב-Google Home בזמן הנכון.

הן גם לא מוציאות זו את זו, ויש כמה נקודות כניסה:

מתפריט ההגדרות

המשתמשים רגילים להגדיר חיבורים למערכות האקולוגיות של Google Home באמצעות תפריט ההגדרות, ולכן השיטה הזו מאפשרת להם להמשיך להשתמש בפרדיגמה הזו.

מומלץ להפריד בין שיתוף מכשירים (Cloud-to-cloud קישור ו-Matter Commissioning API) לבין הרשאות לאפליקציות (Permissions API). כך המשתמשים יכולים לשלוט בשלבים שהם משלימים, ואתם יכולים להציג למשתמשים את סטטוס החיבור.

כשמשתמשים במכשירים באוטומציות שמורצות על ידי Google

בכרטיסייה 'אוטומציות', המשתמשים יכולים להקיש על נקודת כניסה לתהליך השיתוף, לקרוא מסך של הצעת ערך שמסביר בצורה ברורה את היתרונות של המשך התהליך, ואז לעבור במהירות את תהליך ההרשאות.

רק מהזמנה

התרחיש הזה מיועד בעיקר לשותפים שמייצרים רק מכשירי Matter (לא מכשירי Cloud-to-cloud) ואין להם רשת Cloud-to-cloud משלהם.Matter נקודת הכניסה של המשתמש יכולה להיות מיד אחרי מסך מסוג out-of-box, שבו השיתוף של 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. שימוש בביטויים שמניעים לפעולה, כמו "מתחילים כאן".