השדה Google Home Sample App for Matter משתמש Google Home Mobile SDK כדי ליצור אפליקציה ל-Android שדומה ל- Google Home app (GHA). האפליקציה לדוגמה הזו מספקת את התכונות הבאות:
- הזמנת מכשירי Matter פיזיים ווירטואליים אל בד של Android מקומי
- הצמדה של מכשירים פיזיים ווירטואליים למארג פיתוח
- לשלוט במכשירים במארג הפיתוח. לדוגמה, הפעלת קל
- תכונות של מספר אדמינים מאפשרות לשתף מכשירים במארג הפיתוח עם אפליקציות אחרות, ויכול להיות שתוכלו לכלול אותו מכשירי בד שמשותפים מאפליקציות אחרות
- תוכניות שירות למפתחים
במדריך זה מוסבר איך להתקין את ה-APK של Sample App for Matter ולהשתמש בו כדי להפעיל Matter מכשירים, לשלוט בהם ולשתף אותם.
כדי להוריד את קוד המקור, לרשותכם הוראות לשילוב Mobile SDK, והתאמה אישית של המסכים ב-Android Studio, כדאי לנסות Sample App for Matter Codelab.
מעבר אל ה-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כמזהה המוצר. - בנייה של מכשיר אספרסיף
עם
all-clusters-app. אחרי ש יצירת שילוב של Matter בDeveloper Console, יש להשתמש ב-0xFFF1כמזהה הספק וב-0x8001כמזהה המוצר.
לא צריך רכזת, למשל Google Nest Hub (2nd gen), כדי לבצע עמלה ולשלוט במכשירים עם Sample App for Matter.
התקנה
עוברים אל הקטע 'פריטי תוכן' ב-Sample App for Matter GitHub של מאגר הנתונים. של הגרסה האחרונה, מאתרים את הקטע 'נכסים' את ה-APK שנקרא
GHSAFM-version-default-debug.apkלא לסמן אתtargetcommissionerהתקנה של Android Debug Bridge (adb):
מחברים את מכשיר Android באמצעות USB ומפעילים את האפשרות העברת קבצים. לאחר מכן, מתקינים את ה-APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
מכשירי עמלה
כשתפעילו את האפליקציה לדוגמה בפעם הראשונה, תוצג תיבת דו-שיח עם קישור ל-Sample App for Matter Codelab. אם בוחרים באפשרות לא להציג שוב את ההודעה הזו, אפשר להציג שוב את תיבת הדו-שיח. תמיד אפשר לעדכן את ההעדפות בקטע 'ניהול' של האפליקציה.
בשלבים הבאים, צריך להוסיף מכשיר Matter אל בד מקומי של Android, יחד עם בד פיתוח מקומי לדוגמה. אפליקציה בלבד.
מהם בדים של חומר?
בד מסוג Matter הוא דומיין אמון משותף בין מכשירים ברשת ביתית שמאפשרת להם לתקשר זה עם זה.
מכשירים עשויים להכיל בדים אחד או יותר שתואמים לפלטפורמה, לאפליקציה או קבוצה של מכשירים שפועלים יחד. לבדים יש מזהה ומכשירים חולקים את אותה קבוצה של פרטי כניסה ורשות אישורים (CA). פרטי הכניסה האלה מוקצים במהלך Matter בהזמנה.
כדי להזמין מכשיר Matter, צריך לפעול לפי השלבים הבאים:
מקישים על סמל ההוספה לחצן המכשיר כדי להתחיל את תהליך העמלה.
בשלב הבא, אמצעי הבקרה יועבר אל Google Play services, שיופעל משיחה ל-Mobile SDK. כדי להוכיח הוכחה לגבי במכשיר, סורקים קוד QR או מקישים על שימוש בקוד התאמה.
בסיום העמלה, מזינים שם מכשיר ומקישים על סיום.
המכשיר שלך מחובר כעת גם למסך המקומי של Android וגם מארג של פיתוח.
כל עבודות ההזמנה והמסכים המשויכים מטופלות על ידי Play services בעת הזמנת מכשירים. הזה מספק חוויית משתמש עקבית ומבטל את הצורך לטפל בנושאים רגישים למשל, פרטי כניסה ל-Wi-Fi ול-Thread.
שליטה במכשירים
מארג הפיתוח יוצר את פרטי הכניסה כדי לשלוט Matter מכשירים ישירות מהאפליקציה לדוגמה.
במסך הבית, אפשר להפעיל או לכבות את המכשיר. מקישים על המכשיר כדי לגשת לפרטי המכשיר.
שיתוף המכשירים
שיתוף מכשיר נקרא תהליך מרובה-אדמינים המפרט של Matter. אחרי שמזמינים מכשיר לאפליקציה לדוגמה, אפשר לשתף אותו בקלות עם מערכות אקולוגיות אחרות.
כדי לשתף את מכשיר Matter עם סביבות עסקיות אחרות, תצטרכו להתקין פלטפורמה אחרת במכשיר ה-Android. הזה הפלטפורמה החיצונית הופכת לנציבות היעד. יצרנו עוד מופע של האפליקציה לדוגמה שאפשר להשתמש בו בתור נציבות היעד.
עוברים אל הקטע 'פריטי תוכן' ב-Sample App for Matter GitHub של מאגר הנתונים. של הגרסה האחרונה, מאתרים את הקטע 'נכסים' את ה-APK שנקרא
GHSAFM-version-targetcommissioner-debug.apkלא לסמן אתdefaultצריך להתקין את נציב היעד.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkבמסך הבית, מקישים על המכשיר כדי להציג את פרטי המכשיר. מקישים על שיתוף.
האפליקציה לדוגמה מפעילה את ממשק ה-API של שיתוף Mobile SDK שוב, אמצעי הבקרה מועבר אל Play services.
ייפתח גיליון שיתוף שבו תוכלו לבחור את האפליקציה או הפלטפורמה שאליו רוצים להתאים את המכשיר. המסך הזה מספק שתי דרכים לשתף את המכשיר:
- העברה ידנית של קוד הגדרה לשיתוף עם אפליקציית target Commissioner
- באפליקציה מקומית ל-Android שרשומה כ נציב/ה ב-Matter
אפליקציית ועדת היעד מכילה את התווית GHSAFM-TC. מקישים על המופע הזה של אפליקציה לדוגמה לשיתוף המכשיר.
בשלב הבא, האפליקציה החיצונית (Target Commission) משלימה את הזמנת למכשיר עצמו.
הגדרות
במסך הבית, לוחצים על ההגדרות. סמל של . כאן תוכלו לעדכן את העדפות המשתמש, לקבל עזרה ולקבל מידע נוסף על האפליקציה.
התראה על חצי גיליון
במסך ההגדרות, אפשר לבחור להשבית עמלות יזומות התראות גילוי ל-Matter מכשירים.
אם האפליקציה שלכם מספקת תג Matter משלה או אם היא מספקת ייתכן שתרצו להשבית את ההתראות האלה כדי למנוע בלי הפרעות. למידע נוסף, אפשר לקרוא את המאמר איך מונעים גילוי נאות שאפשר להזמין לפיו? התראות אפשר לקבל מידע נוסף.
תוכניות למפתחים
אפשר גם לגשת לכלי עזר למפתחים ממסך ההגדרות.
כדי לבדוק את התוכן של מאגרי הנתונים ב-DataStore של העדפות המכשיר והמשתמש ב-Logcat, מבצעים את השלבים הבאים:
לוחצים על Log repositories content.
לוחצים על OK בתיבת הדו-שיח ומסמנים את התיבה Logcat.
משוב ועזרה
כדי לשלוח לנו את דעתך או משוב לגבי הדרך שבה נוכל לשפר את הפיתוח חוויית השימוש של Sample App for Matter, מלאו את טופס המשוב שלנו.
אם נתקלת בבעיות בSample App for Matter, אפשר לנסות להשלים את התהליך השלבים לאימות הסביבה:
אם יש לכם שאלות בנוגע לשימוש באפליקציה לדוגמה או לגלות באג בקוד, אתם יכולים לשלוח התראות ל'מעקב אחר בעיות' במאגר של GitHub:
כדי לקבל הנחיות רשמיות מ-Google לגבי שאלות טכניות, אפשר להשתמש בבית החכם פורום המפתחים:
כדי לקבל תמיכה טכנית מהקהילה, צריך להשתמש בתג google-smart-home ב-
גלישת מחסנית: