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

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

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

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

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