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

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

ביטול התראות על גילוי נאות שניתנות לעמלה

התראה על חצי גיליון ב-Android
איור 1: דוגמה להתראה ב-Android בגודל חצי דף

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

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

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

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

סימון תמיכה בהפעלת Matter

אם משתמשים ב-Mobile SDK לעמלה, צריך להוסיף את שם חבילת האפליקציה ב-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. אם המשתמשים בוחרים באפשרות Choose other app, היא תופיע במסך אפליקציות אחרות שהותקנו.

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

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

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

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

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