自動化動作可用於自動執行家中的任務和裝置設定。自動化動作在 Google Home 生態系統中已可使用,包括 Google Home app (GHA) 中的日常安排,以及 Google Home for web 上的 automation script editor。
你現在可以透過 Google Home API 使用 Google Home 生態系統中的自動化動作。這兩種 API 採用與 GHA 日常安排和 script editor 相同的基本概念,但提供的功能和能力只有透過 Google Home API 才能使用,包括:
- 存取裝置的所有 Matter 標準和 smart home 特徵,如 Google Home API 所示。
- 支援序列、平行和選取的執行流程。
自動化動作是使用 Automation DSL 編寫的,這是一種網域專屬語言,專門用於以 Kotlin 建構自動化動作。
您要在應用程式中使用 Device & Structure 或 Automation API 的任何特徵和類型,都必須在初始化時註冊。請參閱「初始化住家」。
開發人員旅程
自動化 API 是更大開發歷程的一部分。這項功能會在整合結構體和裝置 API 後提供,確保使用者在想要使用自動化動作時,能夠順利執行。
- 開發人員會規劃自動化動作,並使用 Automation DSL 定義自動化動作。
- 開發人員會將自動化定義嵌入 Kotlin Android 應用程式。
- 應用程式會根據使用者的裝置資訊 (包括使用 Discovery API 或 Device API 收集到的特徵、屬性、指令和事件),向使用者顯示自動化動作。
- 有了 Discovery API,應用程式就能根據使用者結構中的裝置類型和特徵,產生自動化草稿,無論是否有使用者的輸入皆可。
- Device API 可提供與 Discovery API 相同的大部分資訊,但並未針對自動化用途進行最佳化。詳情請參閱「比較 Device API 和 Discovery API」。
- 應用程式會建立實際的自動化動作,並將其與所選結構繫結。
- 自動化動作現在已可在使用者的結構中使用,並可透過結構 API 方法執行或刪除。
使用者隨時可以建立自動化動作的新例項,選擇不同的結構,或根據應用程式邏輯選擇不同的裝置組合。每次執行時,應用程式都會產生自動化動作的新例項。
在最基本的情況下,您可以向使用者建議預先定義的自動化動作,讓他們執行相對基本的工作。或者,您也可以提供自動化動作的骨架,讓使用者根據自身需求進行自訂。或者,您也可以編寫開放式自動化編輯器,讓使用者使用 Automation API 提供的所有建構元素,建構複雜的自動化動作。
資源限制
以下限制適用於 Home API 中的自動化動作:
指標 | 限制 |
---|---|
每個結構體的自動化動作數量上限 | 64 |
每個自動化動作的節點數量上限 | 128 |
每個自動化動作的運算式節點數量上限 | 64 |
每個住家結構體的自動化動作執行個體數量上限 | 1024 |
每個開發人員在每個結構體中的自動化動作執行個體數量上限 | 64 |
每個結構體每天執行次數上限 | 1024 |
每個開發人員每日可執行的結構體數量上限 | 128 |