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

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

השבתת התראות על מודעות Discovery שאפשר להרוויח עליהן עמלות

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