במדריך הזה מפורטות הנחיות לחוויית המשתמש לגבי תכנון הרשאות של מכשירים וממשקי API של Google Home לצורך שיתוף חלק בזמן ההצטרפות לאפליקציה.
הנושאים העיקריים שמפורטים כאן הם:
- למה כדאי לשתף מכשירים עם Google Home?
- שלבים עיקריים בתהליך השיתוף
- הטמעה טכנית
- שיטות מומלצות לשיפור חוויית המשתמש
למה כדאי לשתף מכשירים עם Google Home?
כדי ליהנות מהיכולות של ממשקי Home API, המשתמשים צריכים לשתף את המכשירים שלהם עם Google Home כי:
- זוהי דרישה טכנית ל-Google כדי להשתמש במכשירים האלה בתהליכים אוטומטיים.
- כך אפשר לשמור על חוויית שימוש עקבית וגמישה ב-Google Home.
- חשוב לוודא שהמכשירים מוצגים באופן עקבי בכל האפליקציות שתומכות ב-Home API, כדי למנוע חוויית משתמש מקוטעת ומבלבלת שבה המשתמשים צריכים לעבור בין אפליקציות כדי לבצע משימות בסיסיות.
הרכיבים העיקריים בתהליך השיתוף
רכיב | תוכנית | תיאור |
---|---|---|
Permissions API ב-Android | Home APIs להרשאות ב-Android | מבקשים מהמשתמשים להעניק הרשאות לאפליקציה. לפני שמשתמשים באחד מממשקי ה-API של Home, לאפליקציה צריכה להיות הרשאה לגשת למכשירים בבית של המשתמש (שנקרא ב-API מבנה). עם זאת, הסדר שבו מבצעים את השלב הזה תלוי בתרחיש של המפתח, והוא מפורט בקטע הטמעה טכנית. |
קישור מענן לענן | קישור חשבונות מענן לענן | מאפשרת לכם להתחיל את תהליך קישור החשבון כדי לשתף מכשירים שמחוברים לענן עם Google Home מתוך האפליקציה. כדי לצמצם את החיכוך של המשתמשים, מומלץ להשתמש ביכולת של קישור עומק (זמינה גם ל-Android וגם ל-iOS) שמובילה את המשתמשים ישירות לדף הספציפי של קישור החשבון ב-GHA. |
Commissioning API ב-Android | הזמנת כתבה בנושא | בדרך כלל ה-API הזה נחשב ל-API להפעלת מכשירי Matter חדשים, אבל אפשר להשתמש בו גם כדי להוסיף את Google Fabric למכשירי Matter שכבר הופעלו ב-fabric אחר. לכן, זהו כלי שימושי בתהליך ההצטרפות. |
הטמעה טכנית
אופן היצירה של תהליכי השיתוף תלוי במכשירים שאתם מתכננים לשתף עם Google.
בתרחישים הבאים, מומלץ לפעול לפי השלבים בסדר שמופיע. כך אפשר לספק למשתמשים חוויה כללית טובה יותר.
אתם מייצרים רק מכשירים בתקן Matter
אתם מייצרים מכשירים שתואמים לתקן Matter ואתם רוצים להקצות אותם ל-Google Home.
קוראים ל-Permissions API ב-Android.
קוראים ל-Commissioning API ב-Android בכל מכשיר Matter שהוקצה בעבר למרקם אחר.
- מכיוון ששיתוף Matter צריך להתבצע בכל מכשיר בנפרד, ויש הרבה מסכים שדורשים קלט מהמשתמש, מומלץ להנחות את המשתמש בתהליך הזה:
- לספק למשתמשים רשימה של מכשירי Matter שלא משותפים עם Google.
- לאפשר למשתמשים להתחיל את תהליך שיתוף המכשיר (באמצעות Commissioning API) בלחיצה על המכשירים ברשימה הזו.
- חזרה לרשימה של מכשירי Matter, שבה מוצגים למשתמש ההתקדמות של המשימה וסטטוס השיתוף.
- מכיוון ששיתוף Matter צריך להתבצע בכל מכשיר בנפרד, ויש הרבה מסכים שדורשים קלט מהמשתמש, מומלץ להנחות את המשתמש בתהליך הזה:
אתם מייצרים רק מכשירים ששותפו עם Google באמצעות ממשקי API מענן לענן
מבצעים קישור עומק של Cloud-to-cloud. הפעולה הזו מוסיפה את המכשירים לתרשים Google Home.
- מומלץ לבצע את הקישור של 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.
שיטות מומלצות ל-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 API כדי לתת לאפליקציה גישה ל-Google Home שלהם.
יכול להיות שיהיו כמה אדמינים ב-Google Home שחולקים את המבנה של Google Home, ובמקרים מסוימים יכול להיות שרק חשבון אחד ישמש לשיתוף מכשירים עם Google. לכן, השלמת הקישור של Cloud-to-cloud לא צריכה להיות תנאי מקדים להצגת בקשה להרשאות ל-Home APIs.
הצעות לעיצוב חזותי

יתרון ברור של ההצטרפות ל-Google Home (לדוגמה, 'יצירת פעולות אוטומטיות מתקדמות שמבוססות על Google Home' או 'שליטה במכשירים באמצעות אפליקציות לבחירתך').
קריאה לפעולה (לדוגמה, 'מתחילים') ודרך לבטל אם המשתמש לא רוצה להמשיך.
אם יש מקום, הסבר על מה יקרה כשהמשתמש ימשיך במסכים.
לגבי Matter באופן ספציפי, אם המשתמש העניק לכם גישה לבית שלו באמצעות ממשקי ה-API של Home, תוכלו לאפשר לו לשתף את המכשירים בבית עם Google Home כשהוא מוסיף מכשירים חדשים. לדוגמה, אפשר להוסיף מכשיר Matter ל-Fabric ואז לבקש מהמשתמש להוסיף את המכשיר הזה ל-Google Fabric.
הצעות תוכן
קל יותר למשתמשים לבטוח במשהו שהם מבינים ושנוסף לו ערך. הענקת כלים למשתמשים כדי לקבל החלטות מושכלות, כולל מידע על יתרונות וחסרונות.
השיטה הקריטית
המשתמשים לא ימשיכו לשתף מכשירים אם לא תהיה להם תמורה מספקת על כך.
- חשוב לשים לב לאופן שבו מציגים את המוצר או השירות.
- כדאי ליצור כותרת מעניינת, אבל לא להבטיח יותר מדי.
- אם המשתמש צריך מכשיר שצוין בתוכנית, חשוב לציין זאת בבירור כדי שהוא לא יתקל בבעיה לא צפויה.
- יכול להיות שתהיה לכם רק הזדמנות אחת לזכות את המשתמשים האלה, לכן חשוב לנצל אותה.
שיטות מומלצות
- כדאי להתחיל מנקודת המבט של המשתמש – הגישה של "מה זה יעשה לי?".
- אין לכתוב יותר מארבע שורות תוכן בבלוק של קטע. יותר מילים עלולות לגרום לאובדן תשומת הלב של המשתמש. עם זאת, הבהירות וההבנה יכולות להיות חשובות יותר מקיצור.
- הפעולות האוטומטיות הן כיפיות! אם יש מקום, כדאי לבחור דוגמה מעניינת ומועילה.
- אם זה תואם לאסטרטגיה הכוללת שלכם, נסו להשתמש בקול ובסגנון שובבים.
- כדאי להשתמש בביטויים שמעודדים את המשתמשים לבצע פעולות, כמו 'תחילת העבודה'.