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