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