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