כדי לעזור לכם לפתח אפליקציות ל-Android שמתקשרות עם מכשירי Matter, Google פיתחה את Google Home Mobile SDK. Mobile SDK כולל שני ממשקי API עיקריים שמאפשרים לאפליקציות שלכם להפעיל מכשירים ולשתף אותם עם המארג של Google.
אחרי שמוסיפים מכשיר ל-Google fabric, המשתמשים יכולים לשלוט במכשירים שלהם באמצעות 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 עם גרסה 22.50.14 ומעלה של Play services.
אפשר לראות דוגמה להטמעה במניפסט של Sample App for Matter.
אפשר לבדוק את הזמינות של מודול Home בזמן הריצה באמצעות ModuleInstallClient. מידע נוסף זמין בדף Ensuring API availability with 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.
ל-Codelab של Sample App for Matter
משאבים
מידע נוסף על Mobile SDK זמין במאמרי העזרה של ה-API.
כדי ללמוד איך ערכת ה-SDK הזו מטפלת בנתונים של משתמשי קצה, אפשר לעיין בסעיף אבטחת הנתונים של Google Play בנושא Home Mobile SDK