סקירה כללית על Automation API

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

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

• גישה לכל המאפיינים הרגילים Matter וsmart home של מכשיר, כפי שהם מוצגים ב-Home APIs.
• תמיכה בתהליכי ביצוע רציפים, מקבילים ובתהליכי ביצוע נבחרים.

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

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

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

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

1. המפתח מתכנן את האוטומציה ומגדיר אותה באמצעות Automation DSL.
2. המפתח מטמיע את הגדרת האוטומציה באפליקציית Android ב-Kotlin.
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