סקירה כללית על 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.

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

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

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