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

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

ככלל:

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

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

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

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

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

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

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

    • כדי להשתמש ב-Time.ScheduledTimeEvent, המבנה שבו האוטומציה פועלת צריך לכלול כתובת רחוב שהוגדרה ב-Google Home app (GHA). במאמר שינוי כתובת הבית ב-Google מוסבר איך משתמש יכול להזין את כתובת המבנה. אם הכתובת לא מוגדרת ב-GHA, האוטומציה לא מצליחה ליצור, ומוצגת שגיאה עם ההודעה 'ה-ScheduledTimeEvent לא נתמך על ידי structure'.
    • כדי להשתמש במאפיינים AreaPresenceState או AreaAttendanceState, המשתמש צריך להגדיר את חיישן הנוכחות ב-GHA.
    • כדי להשתמש בתכונת ObjectDetection, המשתמש צריך מינוי פעיל ל-Nest Aware.

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