אוטומציות הן דרך להפוך משימות והגדרות של מכשירים בבית לאוטומטיות. התכונה 'אוטומציות' זמינה במערכת האקולוגית של 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 של המבנה והמכשיר, כדי להבטיח שמשתמש שרוצה להשתמש באוטומציה יוכל לעשות זאת.
- המפתח מתכנן את האוטומציה ומגדיר אותה באמצעות Automation DSL.
- המפתח מטמיע את הגדרת האוטומציה באפליקציית Kotlin Android.
- האפליקציה מציגה למשתמש אוטומציות על סמך מידע על המכשירים שלו, כולל מאפיינים, תכונות, פקודות ואירועים, שנאסף באמצעות Discovery API או Device API.
- באמצעות Discovery API, האפליקציה יכולה ליצור טיוטה של אוטומציה מותאמת אישית לסוגי המכשירים ולמאפיינים שקיימים במבנה של המשתמש, עם או בלי קלט מהמשתמש.
- Device API יכול לספק את רוב המידע ש-Discovery API מספק, אבל הוא לא מותאם לתרחישי שימוש באוטומציה. מידע נוסף זמין במאמר השוואה בין Device API לבין Discovery API.
- האפליקציה יוצרת את האוטומציה בפועל, שמוגדרת לפי המבנה שנבחר.
- האוטומציה זמינה עכשיו במבנה של המשתמש, ואפשר להפעיל או למחוק אותה באמצעות שיטות של Structure API.
המשתמש יכול ליצור מקרים חדשים של האוטומציה בכל שלב, לבחור מבנה אחר או, בהתאם ללוגיקה של האפליקציה, אולי קבוצה אחרת של מכשירים. בכל פעם שהם עושים זאת, האפליקציה יוצרת מופע חדש של האוטומציה.
בתרחיש הכי בסיסי, אפשר להציע למשתמשים אוטומציה מוגדרת מראש שמבצעת משימה בסיסית יחסית. אפשרות אחרת היא להציג למשתמש מסגרת של אוטומציה שהוא יוכל להתאים אישית לצרכים שלו. אפשר גם לכתוב כלי עריכה לאוטומציה עם אפשרויות פתוחות, שיאפשר למשתמש ליצור אוטומציות מורכבות באמצעות כל אבני הבניין שזמינות ב-Automation API.
הגבלות על משאבים
המגבלות הבאות חלות על פעולות אוטומטיות בממשקי ה-API של Home:
מדד | מגבלה |
---|---|
מספר הפעולות האוטומטיות המקסימלי לכל מבנה | 64 |
מספר הצמתים המקסימלי לכל אוטומציה | 128 |
מספר מקסימלי של צמתי ביטוי לכל אוטומציה | 64 |
מספר מקסימלי של מופעים של אוטומציה לכל מבנה | 1024 |
המספר המקסימלי של מופעי אוטומציה לכל מפתח לכל מבנה | 64 |
מספר ההרצות המקסימלי לכל מבנה ביום | 1024 |
מספר ההרצות המקסימלי לכל מפתח לכל מבנה ביום | 128 |