במאמר הזה נסביר על השימוש בתכונות נבחרות של Commissioning API ב-Google Home Mobile SDK.
ביטול התראות Discovery שניתנות לעמלה
כברירת מחדל, האפליקציה Google Play services ב-Android משתמשת בהתראות "חצי גיליון" שמכסות את החלק התחתון של מסך המכשיר הנייד, כדי לספק למשתמשים אינדיקציה יזומה לכך שמכשירי Matter שאפשר להזמין נמצאים בקרבת מקום.
כדי למנוע הפרעות בזמן שהאפליקציה פועלת בחזית, תוכלו להסתיר את ההתראות האלה באמצעות קריאה ל-method suppressHalfSheetNotification() ב-Mobile SDK. למידע נוסף, עיינו במסמכי התיעוד בנושא API.
ההשבתה מופעלת על ידי ה-API הזה מסתיימת אם האפליקציה פועלת בחזית למשך יותר מ-15 דקות. כדי להפעיל מחדש את הביטול אחרי שתם הזמן הקצוב לתפוגה, צריך להפעיל שוב את suppressHalfSheetNotification(), אחרת יתחילו להופיע התראות על חצי הגיליון.
אפשר למצוא הטמעה של ה-API הזה ב-Google Home Sample App for Matter. למידע נוסף, ראו HalfSheetSuppressionObserver.kt.
ציון תמיכה ביצירת עניין בתקן Matter
אם אתם משתמשים בעמלה מסוג Mobile SDK, עליכם להוסיף את השם של חבילת האפליקציה ב-Google Home Developer Console, להטמיע את Matter ממשקי ה-API שלנו ולציין שהאפליקציה שלכם תומכת בעמלה של Matter על ידי טיפול ב-Intent מסוג ACTION_COMMISSION_DEVICE.
צריך להוסיף את intent-filter הבא להצהרה application בקובץ AndroidManifest.xml:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
לעיון במניפסט של האפליקציה לדוגמה.
הכלי לבחירת אפליקציות
האפליקציה מופיעה בכלי לבחירת אפליקציות בשתי דרכים:
- במסך בחירת אפליקציה.
- אם המשתמשים יבחרו באפשרות Choose other app, היא תופיע במסך OtherInstalled Apps (אפליקציות מותקנות אחרות).
הצעות לאפליקציות
בוחר האפליקציות מציג שתי הצעות לאפליקציות.
- הערך הראשון הוא תמיד Google Home app (GHA).
- השיטה השנייה מתאימה לאפליקציה המועדפת של יצרן המכשיר, אם היא מוגדרת בפרויקט Developer Console שמשויך ל-VID או ל-PID של המכשיר.
יש שני תרחישים כשהאפליקציות מופיעות במסך בחירת אפליקציה.
- מותקן – Play services צריך לבדוק שהאפליקציה תומכת במסנן ה-Intent
ACTION_COMMISSION_DEVICE. אם מסנן Intent חסר, המשתמש יופנה לחנות Play כדי לעדכן את האפליקציה. - Noted (לא מותקן) – המשתמש יופנה לחנות Play כדי להתקין את האפליקציה לפני שהוא ימשיך.