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