סקירה כללית על Automation API ב-Android

אוטומציות הן דרך להפוך משימות והגדרות של מכשירים בבית לאוטומטיות. התכונה 'פעולות אוטומטיות' זמינה במערכת האקולוגית של Google Home כתרחישים ב-Google Home app (GHA) ובאמצעות automation script editor ב-Google Home for web.

עכשיו, פעולות אוטומטיות במערכת האקולוגית של Google Home זמינות דרך ממשקי ה-API של Home ל-Android. הם מבוססים על אותם מושגים בסיסיים שמשמשים בתרחישי GHA וב-script editor, אבל עם תכונות ויכולות משופרות שאפשר להשתמש בהן רק באמצעות ממשקי ה-API של Home, כולל:

  • גישה לכל התכונות הרגילות של Matter ושל smart home במכשיר, כפי שמוצג בממשקי ה-API של Home.
  • תמיכה בזרימות ביצוע עוקבות, מקבילות וסלקטיביות.

האוטומציות נכתבות באמצעות Automation DSL, שפה ספציפית לדומיין שנועדה ליצור אוטומציות ב-Kotlin.

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

התהליך שעובר המפתח

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

  1. המפתח מתכנן את האוטומציה ומגדיר אותה באמצעות Automation DSL.
  2. המפתח מטמיע את הגדרת האוטומציה באפליקציית Kotlin Android.
  3. האפליקציה מציגה למשתמש אוטומציות על סמך מידע על המכשירים שלו, כולל מאפיינים, תכונות, פקודות ואירועים, שנאסף באמצעות Discovery API או Device API.
    1. באמצעות Discovery API, האפליקציה יכולה ליצור טיוטה של אוטומציה מותאמת אישית לסוגי המכשירים ולמאפיינים שקיימים במבנה של המשתמש, עם או בלי קלט מהמשתמש.
    2. ‫Device API יכול לספק את רוב המידע ש-Discovery API מספק, אבל הוא לא מותאם לתרחישי שימוש באוטומציה. פרטים נוספים מופיעים במאמר השוואה בין Device API לבין Discovery API.
  4. האפליקציה יוצרת את האוטומציה בפועל, שמוגדרת לפי המבנה שנבחר.
  5. האוטומציה זמינה עכשיו במבנה של המשתמש, ואפשר להפעיל או למחוק אותה באמצעות שיטות של Structure API.

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

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

הגבלות על משאבים

המגבלות הבאות חלות על פעולות אוטומטיות בממשקי Home API:

טבלה: מגבלות משאבים של Automation API
מדד מגבלה
מספר הפעולות האוטומטיות המקסימלי לכל מבנה 64
מספר הצמתים המקסימלי לכל אוטומציה 128
מספר מקסימלי של צמתי ביטוי לכל אוטומציה 64
מספר המופעים המקסימלי של אוטומציה לכל מבנה 1024
מספר המופעים המקסימלי של אוטומציה לכל מפתח לכל מבנה 64
מספר ההרצות המקסימלי לכל מבנה ביום 1024
מספר ההרצות המקסימלי לכל מפתח לכל מבנה ביום 128