כדי לעזור לכם ליצור אפליקציות ל-Android שמקיימות אינטראקציה עם מכשירי Matter, Google פיתחה את Google Home Mobile SDK. Mobile SDK כולל שני ממשקי API מרכזיים שמאפשרים לאפליקציות שלכם להפעיל מכשירים ולשתף אותם עם Google Fabric.
אחרי שמכשיר מתווסף למערכת של Google, המשתמשים יכולים לשלוט במכשירים שלהם באמצעות Google Home app (GHA), אמצעי השליטה בהפעלה של Android, פקודות קוליות ומכשירי Nest עם מסך מגע.
ה-Mobile SDK מאפשר גם להגדיר שירות הפעלה בהתאמה אישית שבו אפשר להשתמש כדי להפעיל מכשירים במערכות אקולוגיות נוספות של Matter.
שילוב Mobile SDK באפליקציה ל-Android
כדי להתחיל, צריך לבצע את הפעולות הבאות:
פועלים לפי ההוראות שמופיעות במאמר בנושא הגדרת Google Play services.
מוסיפים את התלות Play services לקובץ
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
איך מוודאים שהמודול יועבר
המודול Play services home הוא אופציונלי, ולכן הפונקציונליות של Matter תהיה זמינה במכשיר של המשתמש רק אם אפליקציה במכשיר תציין את התלות המתאימה במודול Play services בקובץ AndroidManifest.xml שלה.
הקבצים GHA ו-Google Home Sample App for Matter כוללים את התלות במודול הזה במניפסט שלהם. אם אתם משלבים את Mobile SDK באפליקציית Android, כדי לוודא שיש תמיכה ב-Matter למשתמשים באפליקציה, מוסיפים את בלוק service הבא להצהרת application בקובץ AndroidManifest.xml:
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
האפשרות הזו נתמכת רק במכשירי Android שפועלת בהם גרסה Play services 22.50.14 ומעלה.
דוגמה להטמעה מופיעה במניפסט של Sample App for Matter.
אפשר לבדוק את הזמינות של מודול Home בזמן הריצה באמצעות
ModuleInstallClient. מידע נוסף זמין בדף בנושא הבטחת זמינות של API באמצעות ModuleInstallClient.
שיחות באפליקציות אחרות ל-Android
אם אתם משתמשים ב-Android 11 ואילך, אתם צריכים לכלול את queriesהבלוק הבא ב-AndroidManifest.xml כדי שהאפליקציה שלכם תוכל להתקשר לאפליקציות אחרות.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
מידע נוסף זמין במאמר בנושא סינון של חבילות גלויות ב-Android.
שימוש באפליקציה לדוגמה של Google Home ל-Matter
כדי להבין איך Mobile SDK פועל מאפליקציית Android, אפשר לנסות את Sample App for Matter.
אפשר לנסות את Sample App for Matter
יצירת אפליקציה משלכם
כדי לעזור לכם להתחיל במהירות, פרסמנו את Sample App for Matter בקוד פתוח וסיפקנו Codelab נלווה, שמאפשר לכם להתאים אישית את הקוד לדוגמה שלנו לפרויקטים שלכם ב-Android.
למעבר אל Sample App for Matter ה-codelab
משאבים
מידע נוסף על Mobile SDK מופיע במאמר בנושא הפניית API.
כדי להבין איך ערכת ה-SDK הזו מטפלת בנתונים של משתמשי קצה, אפשר לעיין בסעיף אבטחת הנתונים ב-Google Play בנושא Home Mobile SDK.