Android 上的 Automation API 總覽

自動化動作可自動執行住家中的工作和裝置設定。 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,確保使用者可以順利使用自動化功能。

  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 中的所有建構區塊,建構複雜的自動化程序。

資源限制

以下限制適用於 Home API 中的自動化動作:

表格:Automation API 資源限制
指標 限制
每個住家結構體的自動化動作數量上限 64
每個自動化作業的節點數量上限 128
每個自動化動作的運算式節點數量上限 64
每個住家結構體的自動化動作執行個體數量上限 1024
每個開發人員在每個結構體中可擁有的自動化執行個體數量上限 64
每個結構體每天的執行次數上限 1024
每位開發人員每天可執行的結構數量上限 128