כדי לעזור לכם ליצור אפליקציות ל-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.