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