תמיכה במאפיינים של Automation API ב-Android

‫Automation API ל-Android תומך ברוב התכונות, אבל יכול להיות שהתמיכה בחלק מהמאפיינים, האירועים והפקודות בתכונה תהיה מוגבלת.

ככלל:

• צריך לרשום את כל התכונות והסוגים שרוצים להשתמש בהם באפליקציה באמצעות Automation API בזמן האתחול. איך יוצרים מופע Home
• אפשר להשתמש בכל מאפיין כסימן לתחילת פעולה או כתנאי.
• אי אפשר להשתמש במכשירי Cloud-to-cloud שלא מדווחים על המצב שלהם כטריגרים באוטומציות, בין אם הן נוצרו באופן ידני או באמצעות גילוי.

• גם אם מכשיר תומך בתכונות שמפורטות כאן, יכול להיות שהשימוש בו ייחסם כהתחלה או כפעולה ב-Automation API בגלל סף האיכות של Report State:

  • מכשירים עם שיעור הצלחה של דיווח על מצב נמוך מ-90% נחסמים לשימוש כמכשירים להתחלת שיחות.
  • מכשירים עם שיעור הצלחה בביצוע פקודות שקטן מ-95% נחסמים לשימוש כפעולות.

  ברשימה הזו של דגמי מכשירים מפורטים גם הפעולות וההתחלות הספציפיות שהם תומכים בהן ב-Automations API.

• אפשר להשתמש בפקודות רק כפעולות.

• חלק מהמאפיינים, כמו AssistantBroadcast ו-Notification, זמינים לשימוש רק ב-Automation API.

• הפקודה okGoogle היא פקודה ברמת המבנה, ואפשר להשתמש בה כדי להפעיל אוטומטית כל מכשיר במבנה. עם זאת, יכול להיות שלאפליקציה שמבוססת על Home APIs לא תהיה גישה לכל המכשירים. במאמר הרשאות Ok Google מוסבר איך ההרשאות נאכפות במקרים שונים.

• לחלק מהתכונות יש דרישות מוקדמות:

  • כדי להשתמש בטריגרים לפעולה שמבוססים על זמן, כמו Time.ScheduledTimeEvent,‏ Time.RecurringClockTimeScheduledEvent או Time.RecurringSolarTimeScheduledEvent, המבנה שבו הפעולות האוטומטיות פועלות צריך לכלול כתובת רחוב כדי לקבוע את אזור הזמן המקומי ואת החישובים של השמש. אפשר לספק את הכתובת במהלך יצירת המבנה או להגדיר אותה ב-Google Home app (GHA). במאמר שינוי כתובת מגורים ב-Google מוסבר איך משתמש יכול להזין או לעדכן את כתובת המבנה בGHA. אם הכתובת לא מוגדרת, הפונקציה createAutomation() שומרת ומחזירה את הערך Automation כאשר isValid == false, עם בעיית אימות UnsupportedEntityEvent שכוללת את MissingStructureAddressSetup.
  • כדי שחברי המשפחה יוכלו לקבל התראות מ-Notification.sendNotifications, הם צריכים להתקין את GHA ולהפעיל את ההתראות. ההתראות מועברות לחברים דרך GHA ואי אפשר לשלוח אותן ישירות לאפליקציות של צד שלישי.
  • כדי להשתמש במאפיינים AreaPresenceState או AreaAttendanceState, המשתמש צריך להגדיר את חיישן הנוכחות ב-GHA.
  • כדי להשתמש במאפיין ObjectDetection, למשתמש צריך להיות מינוי פעיל ל-Google Home Premium.

גרסאות פשוטות של חלק מהמאפיינים זמינות גם לשימוש באוטומציות. מידע נוסף זמין במאמר בנושא תכונות פשוטות ב-Android.