ה-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 ל-Fabric המקומי של Android, יחד עם Fabric לפיתוח שמקומי לאפליקציית הדוגמה בלבד.
מהם מאגרי נתונים של Matter?
מארג Matter הוא תחום אמון משותף בין מכשירים ברשת ביתית שמאפשר להם לתקשר ביניהם.
במכשירים יכולים להיות מארגנים אחד או יותר שתואמים לפלטפורמה, לאפליקציה או לקבוצה של מכשירים שמקיימים אינטראקציה יחד. למרקבים יש מזהה ייחודי, והמכשירים משתפים את אותה קבוצת פרטי כניסה ואותה רשות אישורים (CA). פרטי הכניסה האלה מוקצים במהלך ההפעלה של Matter.
כדי להפעיל מכשיר Matter:
מקישים על הלחצן Add Device (הוספת מכשיר) כדי להתחיל בתהליך ההפעלה.
לאחר מכן, השליטה מועברת ל-Google Play services, שמופעל באמצעות קריאה ל-Mobile SDK. כדי להוכיח בעלות, מקישים על סריקת קוד QR או על שימוש בקוד ההתאמה.
בסיום ההפעלה, מזינים שם מכשיר ומקישים על סיום.
עכשיו המכשיר מחובר גם ל-Android 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.
יוצג גיליון שיתוף, שבו תוכלו לבחור את האפליקציה או הפלטפורמה שאליה רוצים להתאים את המכשיר. במסך הזה יש שתי דרכים לשתף את המכשיר:
- באופן ידני באמצעות קוד הגדרה שצריך לשתף עם אפליקציית המפרסם היעד
- באמצעות אפליקציית Android מקומית שרשומה כמפקחת Matter
האפליקציה של הנציב היעד מסומנת בתווית GHSAFM-TC. מקישים על המופע הזה של האפליקציה לדוגמה כדי לשתף את המכשיר.
לאחר מכן, האפליקציה החיצונית (הגורם המבצע את ההזמנה) משלימה את ההזמנה של המכשיר לתוך הפלטפורמה שלה.
הגדרות
במסך הבית, לוחצים על סמל ההגדרות . כאן תוכלו לעדכן את העדפות המשתמש, לקבל עזרה ולקבל מידע נוסף על האפליקציה.
התראה על חצי דף
במסך ההגדרות, אפשר להשבית התראות יזום לגבי פריטים שאפשר להרוויח מהם עמלות במכשירי Matter.
אם באפליקציה שלכם יש תהליך גילוי או הזמנת Matter משלה, מומלץ להשבית את ההתראות האלה כדי למנוע שיבושים. מידע נוסף זמין במאמר השבתה של התראות על הזדמנויות ייחודיות לייצור הכנסות.
כלי עזר למפתחים
במסך ההגדרות אפשר גם לגשת לכלי הפיתוח.
כדי לבדוק את התוכן של המאגרים של DataStore של ההעדפות של המכשיר והמשתמש ב-Logcat, מבצעים את הפעולות הבאות:
לוחצים על תוכן מאגרי יומנים.
לוחצים על אישור בתיבת הדו-שיח ולאחר מכן מסמנים את האפשרות Logcat.
משוב ועזרה
כדי לשלוח לנו משוב על הדרכים שבהן נוכל לשפר את חוויית הפיתוח ב-Sample App for Matter, אפשר למלא את טופס המשוב שלנו.
אם נתקלתם בבעיות ב-Sample App for Matter, נסו לבצע את השלבים הבאים כדי לאמת את הסביבה:
אם יש לכם שאלות לגבי השימוש באפליקציה לדוגמה או אם גיליתם באג בקוד, תוכלו לשלוח בעיות למעקב הבעיות במאגר GitHub:
כדי לקבל הנחיות רשמיות מ-Google לגבי שאלות טכניות, אפשר להשתמש בפורום הפיתוח של Smart Home:
כדי לקבל תמיכה טכנית מהקהילה, צריך להשתמש בתג google-smart-home ב-Stack Overflow: