הזמנה של 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 כדי להפעיל את התכונה, אתם צריכים להוסיף את שם החבילה של האפליקציה ב-Google Home Developer Console, להטמיע את ממשקי ה-API של Matter ולציין שהאפליקציה תומכת בהפעלת התכונה על ידי טיפול ב-intent‏ ACTION_COMMISSION_DEVICE.Matter

מוסיפים את הקוד 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 צריך לוודא שהאפליקציה תומכת במסנן הכוונות ACTION_COMMISSION_DEVICE. אם מסנן הכוונות חסר, המשתמש מופנה לחנות Play כדי לעדכן את האפליקציה.
  2. לא מותקנת – המשתמש מופנה לחנות Play כדי להתקין את האפליקציה לפני שהוא ממשיך.