תהליכי קליטה של משתמשי קצה

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

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

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

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

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

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

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

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

הטמעה טכנית

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

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

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

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

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

2. צריך להפעיל את Google Commissioning API בכל מכשיר Matter שהוקצה בעבר ל-Fabric אחר.

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

אתם מייצרים רק מכשירים ששותפו עם Google באמצעות ממשקי API מענן לענן

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

   1. מומלץ לבצע את הקישור של Cloud-to-cloud קודם כדי למנוע מצבים שעשויים לבלבל את המשתמש, כמו הצגת רשימה שמכילה מכשירים שמשותפים עם Google ומכשירים שלא משותפים עם Google.

2. קוראים ל-Permissions API.

אתם מייצרים מכשירים בתקן Cloud-to-cloud ומכשירים בתקן Matter

1. מבצעים קישור עומק של Cloud-to-cloud.

   1. מומלץ לבצע את הקישור של Cloud-to-cloud קודם כדי למנוע מצבים שעשויים לבלבל את המשתמש, כמו הצגת רשימה שמכילה מכשירים שמשותפים עם Google ומכשירים שלא משותפים עם Google.

2. קוראים ל-Permissions API.

3. צריך להפעיל את Google Commissioning API בכל מכשיר Matter שהוקצה בעבר ל-Fabric אחר.

   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

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

מ-Commissioning בלבד

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

לוגיקה של שיתוף

כמה הצעות להנחיות למשתמש:

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

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

הצעות לעיצוב חזותי

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

• קריאה לפעולה (למשל 'מתחילים') ודרך לבטל אם המשתמש לא רוצה להמשיך.

• אם יש מספיק מקום, הסבר על מה יקרה כשהמשתמש ימשיך במסכים.

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

הצעות תוכן

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

המיקום הקריטי

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

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

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

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