הזמנה של SDK לנייד בבית

בדף הזה מוסבר איך להשתמש בתכונות נבחרות של commissioning API ב-Google Home Mobile SDK.

הפסקה של התראות על גילוי מוצרים שניתן לקבל עליהם עמלה

התראה בחצי מסך ב-Android
תרשים 1: דוגמה להתראה בחצי גיליון ב-Android

כברירת מחדל, Google Play services ב-Android משתמש בהתראות מסוג 'חצי דף' שמכסות את החצי התחתון של המסך במכשיר נייד, כדי לספק למשתמשים אינדיקציה פרואקטיבית לכך שמכשירים שניתן לקבל עליהם עמלה נמצאים בקרבת מקום.Matter

כדי למנוע הפרעות בזמן שהאפליקציה בחזית, אפשר להשבית את ההתראות האלה באמצעות קריאה לשיטה suppressHalfSheetNotification() ב-Mobile SDK. מידע נוסף זמין במסמכי העזרה של ה-API.

ההשבתה שמופעלת על ידי ה-API הזה מסתיימת אם האפליקציה נמצאת בחזית למשך יותר מ-15 דקות. כדי להפעיל מחדש את ההסתרה אחרי זמן קצוב לתפוגה, צריך להתקשר שוב אל suppressHalfSheetNotification(). אחרת, יתחילו להופיע התראות על חצי דף.

הטמעה של ה-API הזה נמצאת ב-Google Home Sample App for Matter. מידע נוסף זמין במאמר HalfSheetSuppressionObserver.kt.

איך מציינים תמיכה בהוספת מכשירים ל-Matter

אם אתם משתמשים ב-Mobile SDK כדי להפעיל את התכונה, אתם צריכים להוסיף את שם חבילת ה-APK ב-Google Home Developer Console, להטמיע את ממשקי ה-API של Matter ולציין שהאפליקציה תומכת בהפעלת Matter על ידי טיפול ב-intent‏ ACTION_COMMISSION_DEVICE.

מוסיפים את intent-filter להצהרת application בקובץ AndroidManifest.xml:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

לעיון, אפשר לראות את מניפסט האפליקציה לדוגמה.

בורר האפליקציות

בורר האפליקציות

יש שתי דרכים שבהן האפליקציה שלכם מופיעה בבורר האפליקציות במהלך תהליך ההפעלה:

  1. במסך בחירת אפליקציה.
  2. אם המשתמשים יבחרו באפשרות בחירת אפליקציה אחרת, היא תוצג במסך אפליקציות אחרות שהותקנו.

הצעות לאפליקציות

בבורר האפליקציות מוצגות שתי אפליקציות מומלצות.

  • הראשון הוא תמיד Google Home app (GHA).
  • השני הוא לאפליקציה המועדפת של יצרן המכשיר, אם היא מוגדרת בDeveloper Console פרויקט שמשויך למזהה הספק (VID) או למזהה המוצר (PID) של המכשיר. אפליקציית הנציבות המועדפת של יצרן המכשיר

יש שני תרחישים שבהם האפליקציות מופיעות במסך בחירת אפליקציה.

  1. מותקן – Play services צריך לוודא שהאפליקציה תומכת במסנן Intent ACTION_COMMISSION_DEVICE. אם מסנן Intent חסר, המשתמש מופנה לחנות Play כדי לעדכן את האפליקציה.
  2. לא מותקנת – המשתמש מופנה לחנות Play כדי להתקין את האפליקציה לפני שהוא ממשיך.