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

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

ככלל:

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

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

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

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

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

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

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

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

  • כדי להשתמש באירועים התחלתיים שמבוססים על זמן, כמו 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.