Android 上的 Automation API 總覽

自動化動作可用於自動執行住家中的任務和裝置設定。自動化動作已在 Google Home 生態系統中推出，可透過 Google Home app (GHA) 中的日常安排和 Google Home for web 的 automation script editor 使用。

你現在可以透過 Android 版 Google Home API 使用 Google Home 生態系統中的自動化動作。這兩種功能使用與 GHA 日常安排和 script editor 相同的基本概念，但透過 Google Home API 提供的功能和能力更為強大，包括：

• 存取裝置的所有 Matter 標準和 smart home 特徵，如 Google Home API 所示。
• 支援序列、並行和選取的執行流程。

自動化動作會使用 Automation DSL 編寫，這是一種專門用於以 Kotlin 建構自動化動作的領域特定語言。

您要在應用程式中使用 Device & Structure 或 Automation API 的任何特徵和類型，都必須在初始化時註冊。請參閱「在 Android 上初始化住家」。

開發人員旅程

Automation API 是更大開發歷程的一部分。這項功能會在整合 Structure API 和 Device 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. 自動化動作現在已可在使用者的結構中使用，並可透過結構 API 方法執行或刪除。

使用者隨時可以建立自動化動作的新例項，選擇不同的結構，或根據應用程式邏輯選擇不同的裝置組合。每次執行時，應用程式都會產生自動化動作的新例項。

在最基本的情況下，您可以向使用者建議預先定義的自動化動作，執行相對基本的工作。或者，您也可以提供自動化動作的骨架，讓使用者根據自身需求進行自訂。或者，您也可以編寫開放式自動化編輯器，讓使用者使用 Automation API 提供的所有建構元素，建構複雜的自動化動作。

資源限制

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