הזמנה של 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 כדי להתקין את האפליקציה לפני שהוא ממשיך.