Google Home Sample App for Matter משתמש ב-Google Home Mobile SDK כדי ליצור אפליקציית Android שדומה ל-Google Home app (GHA). אפליקציית הדוגמה הזו כוללת את התכונות הבאות:
- הפעלת מכשירי Matter פיזיים ווירטואליים ב-Local Android fabric
- הקצאת מכשירים פיזיים ווירטואליים לרשת פיתוח
- שליטה במכשירים ברשת הפיתוח, למשל הדלקת אור
- תכונות של כמה אדמינים מאפשרות לכם לשתף מכשירים ברשת הפיתוח עם אפליקציות אחרות, ולהיפך – לכלול ברשת הפיתוח מכשירים ששותפו מאפליקציות אחרות.
- כלי עזר למפתחים
במדריך הזה מוסבר איך להתקין את קובץ ה-APK של Sample App for Matter ולהשתמש בו כדי להפעיל, לשלוט ולשתף מכשירי Matter.
כדי להוריד את קוד המקור, ללמוד איך לשלב את Mobile SDK ולהתאים אישית מסכים ב-Android Studio, כדאי לנסות את ה-codelab שלנו בנושא Sample App for Matter.
מעבר אל Sample App for Matter ה-codelab
דרישות מוקדמות
- מכשיר Android O (8.1, רמת API 27) או מכשיר חדש יותר שזמין לבדיקה. כדי לוודא שבמכשיר שלכם יש את התמיכה העדכנית ביותר, כדאי לעיין במדריך אימות של מודולים ושירותים.MatterMatter
- בניית מכשיר 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 במאגר Sample App for Matter GitHub. בקטע 'נכסים' מאתרים את קובץ ה-APK שנקרא
GHSAFM-version-default-debug.apk. לא בוחרים באפשרותtargetcommissioner.מתקינים את ממשק הגישור של Android (adb):
מחברים את מכשיר Android באמצעות USB ומפעילים את העברת הקבצים, ואז מתקינים את ה-APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
חיבור מכשירים
כשמפעילים את האפליקציה לדוגמה בפעם הראשונה, מוצגת תיבת דו-שיח עם קישור ל-Sample App for Matter codelab. אם בוחרים באפשרות אני לא רוצה לראות את ההודעה הזאת בעתיד, אפשר להציג את תיבת הדו-שיח שוב בכל שלב על ידי עדכון ההעדפות בקטע'ניהול' באפליקציה.
בשלבים הבאים תוסיפו מכשיר Matter למסגרת המקומית של Android, יחד עם מסגרת פיתוח מקומית שרלוונטית רק לאפליקציית הדוגמה.
מהם בדים של Matter?
Matter רשת היא דומיין משותף של מהימנות בין מכשירים ברשת ביתית, שמאפשר להם לתקשר ביניהם.
יכול להיות שלמכשירים יש בד אחד או יותר שמתאימים לפלטפורמה, לאפליקציה או לקבוצת מכשירים שפועלים יחד. לכל רשת יש מזהה ייחודי, ולמכשירים יש את אותה קבוצה של פרטי כניסה ורשות אישורים (CA). פרטי הכניסה האלה מוקצים במהלך הפעלת Matter.
כדי להפעיל מכשיר Matter, מבצעים את השלבים הבאים:
מקישים על הלחצן הוספת מכשיר כדי להתחיל בתהליך ההפעלה.
לאחר מכן, השליטה מועברת אל Google Play services, שמופעלת משיחה אל Mobile SDK. כדי להוכיח בעלות, סורקים את קוד ה-QR או מקישים על שימוש בקוד התאמה.
בסיום ההפעלה, מזינים שם מכשיר ומקישים על סיום.
המכשיר שלכם מחובר עכשיו גם לרשת המקומית של Android וגם לרשת הפיתוח.
כל תהליך ההפעלה והמסכים שקשורים אליו מנוהלים על ידי Play services כשמפעילים מכשירים. כך אנחנו מספקים חוויית משתמש עקבית ומבטלים את הצורך בטיפול בהרשאות רגישות, למשל, אישורים של Wi-Fi ו-Thread.
שליטה במכשירים
הפלטפורמה לפיתוח יוצרת את פרטי הכניסה לשליטה במכשירי Matter ישירות מאפליקציית הדוגמה.
ממסך הבית, אפשר להעביר את המכשיר למצב מופעל או מושבת. מקישים על המכשיר כדי לגשת לפרטי המכשיר.
שיתוף מכשירים
שיתוף מכשיר נקרא תהליך מרובה-אדמינים במפרט Matter. אחרי שמפעילים מכשיר באפליקציית הדוגמה, אפשר לשתף אותו בקלות עם מערכות אקולוגיות אחרות.
כדי לשתף את מכשיר Matter עם מערכות אקולוגיות אחרות, צריך להתקין פלטפורמה נוספת במכשיר Android. הפלטפורמה החיצונית הזו הופכת לפלטפורמת היעד להקצאת הרשאות. יצרנו מופע נוסף של האפליקציה לדוגמה שבו אפשר להשתמש בתור הגורם המוסמך היעד.
עוברים אל הקטע Releases במאגר Sample App for Matter GitHub. בקטע 'נכסים' מאתרים את קובץ ה-APK שנקרא
GHSAFM-version-targetcommissioner-debug.apk. לא בוחרים באפשרותdefault.מתקינים את המקבל של העמלה.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkבמסך הבית, מקישים על המכשיר כדי להציג את פרטי המכשיר. מקישים על שיתוף.
אפליקציית הדוגמה קוראת ל-Mobile SDK Share API ושוב, השליטה מועברת ל-Play services.
יוצג גיליון שיתוף שבו תוכלו לבחור את האפליקציה או הפלטפורמה שאליהן אתם רוצים להתאים את המכשיר. במסך הזה יש שתי דרכים לשתף את המכשיר:
- באופן ידני באמצעות קוד הגדרה שמשותף עם אפליקציית הנציב של היעד
- באמצעות אפליקציית Android מקומית שנרשמה כMatter
אפליקציית היעד של הנציב מסומנת בתווית GHSAFM-TC. מקישים על המופע הזה של האפליקציה לדוגמה כדי לשתף את המכשיר.
לאחר מכן, האפליקציה החיצונית (הגורם המפעיל של היציאה משימוש) משלימה את הפעלת המכשיר ברשת שלה.
הגדרות
במסך הבית, לוחצים על סמל ההגדרות . כאן יש לכם אפשרויות לעדכן את העדפות המשתמש, לקבל עזרה ולקרוא מידע נוסף על האפליקציה.
התראה על חצי גיליון
במסך ההגדרות, אפשר להשבית את ההתראות הפרואקטיביות על גילוי מכשירים שניתן להפעיל בהם עמלה עבור Matter.
אם האפליקציה שלכם מספקת תהליך משלה לMatterגילוי או להזמנה של שירותים, יכול להיות שתרצו להשבית את ההתראות האלה כדי למנוע הפרעות. מידע נוסף זמין במאמר בנושא השבתת התראות על גילוי מוצרים שניתן לקבל עליהם עמלה.
כלי עזר למפתחים
במסך ההגדרות אפשר גם לגשת אל כלי עזר למפתחים.
כדי לבדוק את התוכן של מאגרי נתונים של העדפות מכשיר והעדפות משתמש ב-Logcat, פועלים לפי השלבים הבאים:
לוחצים על Log repositories content (רישום תוכן במאגרי מידע).
לוחצים על אישור בתיבת הדו-שיח, ואז מסמנים את האפשרות Logcat.
משוב ועזרה
כדי לשלוח רעיונות או משוב על שיפור חוויית הפיתוח באמצעות Sample App for Matter, אפשר למלא את טופס המשוב שלנו.
אם נתקלתם בבעיות ב-Sample App for Matter, נסו להשלים את השלבים לאימות הסביבה:
אם יש לכם שאלות לגבי השימוש באפליקציה לדוגמה או אם גיליתם באג בקוד, אתם יכולים לשלוח בעיות ל-Issue Tracker במאגר GitHub:
כדי לקבל הנחיות רשמיות מ-Google בנוגע לשאלות טכניות, אפשר להשתמש בפורום המפתחים של הבית החכם:
כדי לקבל תמיכה טכנית מהקהילה, משתמשים בתג google-smart-home ב-Stack Overflow: