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