自動化動作可自動執行住家中的工作和裝置設定。 Google Home 生態系統的自動化功能已推出一段時間,使用者可透過 Google Home app (GHA) 和 automation script editor 存取Google Home for web。
現在,Android 適用的 Home API 可支援 Google Home 生態系統的自動化動作。這些功能與GHA日常安排script editor和 Google Home 應用程式使用的基本概念相同,但透過 Google Home API 提供的強化功能和服務,可實現以下目標:
- 存取裝置的所有Matter標準和smart home特徵,如居家控制系統 API 所示。
- 支援循序、平行和選取執行流程。
自動化動作是使用 Automation DSL 編寫而成,這是一種專為在 Kotlin 中建構自動化動作而設計的領域特定語言。
如要在應用程式中使用裝置和結構體或 Automation API,必須在初始化時註冊所有特徵和型別。請參閱「在 Android 上初始化住家」。
開發人員旅程
自動化 API 是大型開發歷程的一部分。整合 Structure 和 Device API 後,請務必整合 Automation API,確保使用者可以順利使用自動化功能。
- 開發人員規劃自動化作業,並使用 Automation DSL 定義。
- 開發人員會在 Kotlin Android 應用程式中嵌入自動化定義。
- 應用程式會根據使用者裝置的相關資訊 (包括特徵、屬性、指令和事件),透過 Discovery API 或 Device API 收集這些資訊,並向使用者顯示自動化動作。
- 透過 Discovery API,應用程式可以根據使用者結構中的裝置類型和特徵,產生自訂的自動化草稿,使用者可選擇是否提供輸入內容。
- Device API 可提供與 Discovery API 大致相同的資訊,但並未針對自動化用途進行最佳化。詳情請參閱「比較 Device API 和 Discovery API」。
- 應用程式會根據所選結構建立實際的自動化程序。
- 自動化作業現在已在使用者結構中提供,可使用 Structure API 方法執行或刪除。
使用者隨時可以建立新的自動化動作例項,選取不同的結構,或根據應用程式邏輯,選取不同的裝置組合。每次執行這項操作時,應用程式都會產生新的自動化作業例項。
在最基本的情況下,您可能會向使用者建議預先定義的自動化程序,執行相對基本的工作。或者,您也可以提供自動化作業的架構,讓使用者根據需求自訂。或者,您也可以編寫開放式自動化編輯器,讓使用者運用 Automation API 中的所有建構區塊,建構複雜的自動化程序。
資源限制
以下限制適用於 Home API 中的自動化動作:
指標 | 限制 |
---|---|
每個住家結構體的自動化動作數量上限 | 64 |
每個自動化作業的節點數量上限 | 128 |
每個自動化動作的運算式節點數量上限 | 64 |
每個住家結構體的自動化動作執行個體數量上限 | 1024 |
每個開發人員在每個結構體中可擁有的自動化執行個體數量上限 | 64 |
每個結構體每天的執行次數上限 | 1024 |
每位開發人員每天可執行的結構數量上限 | 128 |