השדה 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.
התקנה
עוברים לקטע 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
מכשירי עמלה
כשתפעילו את האפליקציה לדוגמה בפעם הראשונה, תוצג תיבת דו-שיח עם קישור ל-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. הזה הפלטפורמה החיצונית הופכת לנציבות היעד. יצרנו מופע נוסף של האפליקציה לדוגמה, שאפשר להשתמש בו כגורם המבצע של הבקשה.
עוברים אל הקטע 'פריטי תוכן' ב-Sample App for Matter GitHub של מאגר הנתונים. כדי למצוא את הגרסה האחרונה, מאתרים בקטע 'נכסים' את חבילת ה-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 Commission) משלימה את הזמנת למכשיר עצמו.
הגדרות
במסך הבית, לוחצים על ההגדרות. סמל של . כאן תוכלו לעדכן את העדפות המשתמש, לקבל עזרה ולקבל מידע נוסף על האפליקציה.
התראה על חצי גיליון
במסך ההגדרות, אפשר להשבית התראות יזום לגבי פריטים שאפשר להרוויח מהם עמלות במכשירים מסוג Matter.
אם האפליקציה שלכם מספקת תג Matter משלה או אם היא מספקת ייתכן שלא תרצו להציג התראות אלה, בלי הפרעות. מידע נוסף זמין במאמר השבתה של התראות על הזדמנויות ייחודיות לייצור הכנסות.
כלי עזר למפתחים
במסך ההגדרות אפשר גם לגשת לכלי הפיתוח.
כדי לבדוק את התוכן של המאגרים של DataStore של ההעדפות של המכשיר והמשתמש ב-Logcat, מבצעים את הפעולות הבאות:
לוחצים על Log repositories content.
לוחצים על OK בתיבת הדו-שיח ומסמנים את התיבה Logcat.
משוב ועזרה
כדי לשלוח לנו את דעתך או משוב לגבי הדרך שבה נוכל לשפר את הפיתוח חוויית השימוש של Sample App for Matter, מלאו את טופס המשוב שלנו.
אם נתקלת בבעיות בSample App for Matter, אפשר לנסות להשלים את התהליך השלבים לאימות הסביבה:
אם יש לכם שאלות בנוגע לשימוש באפליקציה לדוגמה או לגלות באג בקוד, אתם יכולים לשלוח התראות ל'מעקב אחר בעיות' במאגר של GitHub:
כדי לקבל הנחיות רשמיות מ-Google לגבי שאלות טכניות, אפשר להשתמש בפורום הפיתוח של Smart Home:
כדי לקבל תמיכה טכנית מהקהילה, צריך להשתמש בתג google-smart-home ב-Stack Overflow: