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