ה-Google Home Sample App for Matter משתמש ב-Google Home Mobile SDK כדי ליצור אפליקציה ל-Android שדומה ל-Google Home app (GHA). האפליקציה לדוגמה הזו מספקת את התכונות הבאות:
- הקצאה של מכשירי Matter פיזיים ווירטואליים ל-Local Android fabric
- הקצאת מכשירים פיזיים ווירטואליים לרקמת פיתוח
- לשלוט במכשירים בסביבת הפיתוח, למשל להדליק תאורה
- התכונות של ניהול על ידי כמה אדמינים מאפשרות לכם לשתף מכשירים ב-Fabric לפיתוח עם אפליקציות אחרות, ולהפך, לכלול ב-Fabric לפיתוח מכשירים ששותפו מאפליקציות אחרות.
- כלים למפתחים
במדריך הזה מוסבר איך להתקין את קובץ ה-APK של Sample App for Matter ולהשתמש בו כדי להפעיל, לשלוט ולשתף מכשירי Matter.
כדי להוריד את קוד המקור, ללמוד איך לשלב את Mobile SDK ולהתאים אישית מסכים ב-Android Studio, תוכלו לנסות את ה-codelab Sample App for Matter שלנו.
כניסה ל-Codelab של Sample App for Matter
דרישות מוקדמות
- מכשיר Android O (8.1, API ברמה 27) או מכשיר חדש יותר שזמין לבדיקה. כדי לוודא שבמכשיר שלכם מותקנת התמיכה העדכנית ביותר ב-Matter, תוכלו לעיין במדריך אימות המודולים והשירותים של Matter.
- פיתוח מכשיר Matter עם יכולות הפעלה/כיבוי. האפליקציה לדוגמה פועלת עם מכשיר וירטואלי ועם ESP32.
- מכשיר וירטואלי של Matter (MVD). כדי למזער בעיות בסביבה, מומלץ מאוד להשתמש ב-MVD בהתחלה. אם נתקלתם בבעיות, יהיה לכם קל יותר לבדוק אותן אם תשתמשו באפליקציית הדוגמה מול MVD.
- יוצרים מכשיר וירטואלי של Matter
באמצעות אפליקציית
rootnode_dimmablelight_bCwGYSDpoe. כשאתם יוצרים שילוב של Matter ב-Google Home Developer Console, משתמשים ב-0xFFF1בתור מזהה הספק וב-0x8000כמזהה המוצר. - בונים מכשיר Espressif עם
all-clusters-app. כשיוצרים שילוב של Matter ב-Developer Console, אפשר להשתמש ב-0xFFF1כמזהה הספק וב-0x8001כמזהה המוצר.
אין צורך ברכזת, למשל Google Nest Hub (2nd gen), כדי להגדיר ולשלוט במכשירים באמצעות Sample App for Matter.
התקנה
עוברים לקטע Releases במאגר GitHub של Sample App for Matter. כדי למצוא את הגרסה האחרונה, מאתרים בקטע 'נכסים' את חבילת ה-APK בשם
GHSAFM-version-default-debug.apk. לא לבחור ב-targetcommissioner.התקנת Android Debug Bridge (adb):
מחברים את מכשיר Android באמצעות USB ומפעילים את העברת קבצים, ואז מתקינים את קובץ ה-APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
חיבור מכשירים
כשאתם מריצים את האפליקציה לדוגמה בפעם הראשונה, מוצגת תיבת דו-שיח עם קישור לcodelab של Sample App for Matter. אם בוחרים באפשרות אני לא רוצה לראות את ההודעה הזאת בעתיד, אפשר להציג שוב את תיבת הדו-שיח בכל שלב על ידי עדכון ההעדפות בקטע 'אדמין' באפליקציה.
בשלבים הבאים תוסיפו מכשיר Matter למארג של Android המקומי, יחד עם מארג של פיתוח שמקומי לאפליקציה לדוגמה.
מהם בדים מסוג חומר?
מארג Matter הוא תחום אמון משותף בין מכשירים ברשת ביתית שמאפשר להם לתקשר ביניהם.
יכול להיות שלמכשירים יהיו מארגים אחד או יותר שתואמים לפלטפורמה, לאפליקציה או לקבוצה של מכשירים שמקיימים אינטראקציה יחד. למרקבים יש מזהה ייחודי, והמכשירים משתפים את אותה קבוצת פרטי כניסה ואותה רשות אישורים (CA). פרטי הכניסה האלה מוקצים במהלך ההפעלה של Matter.
כדי להזמין מכשיר Matter, צריך לפעול לפי השלבים הבאים:
לוחצים על הלחצן Add Device (הוספת מכשיר) כדי להתחיל את תהליך העמלה.
לאחר מכן, השליטה מועברת ל-Google Play services, שמופעל באמצעות קריאה ל-Mobile SDK. כדי להוכיח בעלות, סורקים את קוד ה-QR או מקישים על שימוש בקוד התאמה.
בסיום העמלה, מזינים שם מכשיר ומקישים על סיום.
עכשיו המכשיר מחובר גם ל-Fabric המקומי של Android וגם ל-Fabric של הפיתוח.
כל עבודת ההפעלה הראשונית והמסכים המשויכים מטופלים על ידי Play services כשמפעילים את המכשירים. כך אפשר לספק חוויית משתמש עקבית ואין צורך לטפל בהרשאות רגישות, כמו פרטי כניסה ל-Wi-Fi ול-Thread.
שליטה במכשירים
מארג הפיתוח יוצר את פרטי הכניסה כדי לשלוט במכשירים ב-Matter ישירות מהאפליקציה לדוגמה.
אפשר להגדיר את המכשיר כמופעל או כבוי במסך הבית. כדי לגשת לפרטי המכשיר, מקישים על המכשיר.
שיתוף המכשירים
שיתוף מכשיר נקרא תהליך עם כמה אדמינים במפרט Matter. אחרי שמכשיר מסוים מוקצה לאפליקציית הדוגמה, אפשר לשתף אותו בקלות עם סביבות עסקיות אחרות.
כדי לשתף את מכשיר Matter עם סביבות עסקיות אחרות, צריך להתקין פלטפורמה אחרת במכשיר Android. הפלטפורמה החיצונית הזו הופכת למפעילת היעד. יצרנו מופע נוסף של האפליקציה לדוגמה, שאפשר להשתמש בו כגורם המבצע של הבקשה.
עוברים לקטע Releases במאגר GitHub של Sample App for Matter. כדי למצוא את הגרסה האחרונה, מאתרים בקטע 'נכסים' את חבילת ה-APK בשם
GHSAFM-version-targetcommissioner-debug.apk. לא לבחור ב-default.מתקינים את הגורם המבצע של היעד.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkבמסך הבית, מקישים על המכשיר כדי להציג את פרטי המכשיר. מקישים על שיתוף.
האפליקציה לדוגמה קוראת ל-Share API של Mobile SDK, שוב, השליטה מועברת ל-Play services.
יוצג גיליון שיתוף, שבו תוכלו לבחור את האפליקציה או הפלטפורמה שאליה רוצים להתאים את המכשיר. במסך הזה יש שתי דרכים לשתף את המכשיר:
- קוד הגדרה שישותף באופן ידני עם אפליקציית target Commissioner
- באמצעות אפליקציית Android מקומית שרשומה כמפקחת Matter
האפליקציה של הנציב היעד מסומנת בתווית GHSAFM-TC. כדי לשתף את המכשיר, מקישים על המופע הזה של האפליקציה לדוגמה.
בשלב הבא, האפליקציה החיצונית (Target Commissioner) משלימה את הזמנת המכשיר למארג נפרד.
הגדרות
במסך הבית, לוחצים על סמל ההגדרות . כאן תוכלו לעדכן את העדפות המשתמשים, לקבל עזרה ולקבל מידע נוסף על האפליקציה.
התראה על חצי דף
במסך ההגדרות, אפשר להשבית התראות יזום לגבי פריטים שאפשר להרוויח מהם עמלות במכשירי Matter.
אם האפליקציה שלכם מספקת תהליך משלה לחיפוש או להפעלה של Matter, מומלץ להפסיק את ההתראות האלה כדי למנוע שיבושים. מידע נוסף זמין במאמר השבתה של התראות על הזדמנויות ייחודיות לייצור הכנסות.
כלי עזר למפתחים
במסך ההגדרות אפשר גם לגשת לכלי הפיתוח.
כדי לבדוק את התוכן של המאגרים של DataStore של ההעדפות של המכשיר והמשתמש ב-Logcat, פועלים לפי השלבים הבאים:
לוחצים על תוכן מאגרי יומנים.
לוחצים על אישור בתיבת הדו-שיח ולאחר מכן מסמנים את Logcat.
משוב ועזרה
כדי לספר לנו מה דעתכם או משוב לגבי האופן שבו נוכל לשפר את חוויית הפיתוח עם Sample App for Matter, מלאו את טופס המשוב שלנו.
אם נתקלתם בבעיות ב-Sample App for Matter, נסו לבצע את השלבים הבאים כדי לאמת את הסביבה:
אם יש לכם שאלות לגבי השימוש באפליקציה לדוגמה או זיהיתם באג בקוד, תוכלו לשלוח בעיות ל-(פותר הבעיות) במאגר של GitHub:
כדי לקבל הנחיות רשמיות מ-Google לשאלות טכניות, תוכלו להיעזר בפורום למפתחים של הבית החכם:
כדי לקבל תמיכה טכנית מהקהילה, צריך להשתמש בתג google-smart-home ב-Stack Overflow: