תהליכי ההצטרפות של משתמשי קצה ב-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 ב-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.

   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.

שיטות מומלצות לשיפור חוויית המשתמש

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

הצעות תוכן

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

הצגת המוצר הקריטית

המשתמשים לא ימשיכו בתהליך של שיתוף מכשירים אם לא יהיה להם תמריץ חזק לעשות זאת.

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

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

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