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

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

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

• למה כדאי לשתף מכשירים עם 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 ב-Android	הפעלת Matter	למרות שבדרך כלל חושבים על ה-API הזה כעל API להפעלת מכשירי Matter חדשים, אפשר להשתמש בו גם כדי להוסיף את Google Fabric למכשירי Matter שכבר הופעלו ב-Fabric אחר. לכן, זהו כלי שימושי לתהליך ההצטרפות.

הטמעה טכנית

אופן יצירת תהליכי השיתוף תלוי במכשירים שאתם מתכננים לשתף עם 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

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

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

זו רשימה חלקית בלבד, ויכול להיות שתמצאו הזדמנויות אחרות להציע למשתמשים שלכם חוויית שיתוף ושימוש ב-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 API, תוכלו לאפשר לו לשתף את המכשירים בבית שלו עם Google Home כשהוא מוסיף מכשירים חדשים. לדוגמה, אפשר להוסיף Matter מכשיר ל-Fabric ואז לבקש מהמשתמש להוסיף את המכשיר הזה ל-Google Fabric.

הצעות תוכן

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

הגובה הקריטי

המשתמשים לא ימשיכו בתהליך של שיתוף מכשירים אם לא יהיה לכך ערך מוסף משמעותי.

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

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

1. תתחילו מנקודת המבט של המשתמש – מה יוצא לו מזה?
2. אל תכתבו יותר מארבע שורות של תוכן בבלוק של קטע. יותר מדי מילים עלולות לגרום למשתמשים לאבד עניין. עם זאת, בהירות והבנה יכולות להיות חשובות יותר מתמציתיות.
3. אוטומציות זה כיף! אם יש מקום, כדאי לבחור דוגמה מעניינת ומועילה.
4. אם זה מתאים לאסטרטגיה הכוללת שלכם, נסו להשתמש בסגנון שובב.
5. שימוש בביטויים שמעודדים פעולה, כמו "מתחילים כאן".