Android 適用的 Automation API 支援大多數特徵,但特徵中的部分屬性、事件和指令可能僅支援有限功能。
如要確認 Automation API 是否支援您的用途,請在下表搜尋。
一般而言:
- 如要在應用程式中使用 Automation API,必須在初始化時註冊所有特徵和型別。請參閱「建立 Home 執行個體」。
- 啟動條件或限制條件可使用任何屬性。
- 如果 Cloud-to-cloud 裝置不會回報狀態,就無法在自動化動作中做為觸發條件,無論是手動建立或透過探索建立都一樣。
即使裝置支援這裡列出的特徵,但如果回報狀態品質未達門檻,裝置可能無法在 Automation API 中做為啟動器或動作使用:
- 如果裝置的「回報狀態」成功率低於 90%,就無法做為啟動器。
- 如果裝置的指令執行成功率低於 95%,就無法做為動作使用。
請參閱這份裝置型號清單,瞭解自動化 API 支援的特定啟動條件和動作。
指令只能做為動作使用。
部分特徵 (例如
AssistantBroadcast
) 只能在 Automation API 中使用。okGoogle
指令是結構層級的指令,可用於自動控制結構中的任何裝置。不過,Home API 應用程式可能無法存取所有裝置。請參閱「Ok Google 權限」,瞭解在各種情況下如何強制執行權限。部分特徵有先決條件:
- 如要使用
Time.ScheduledTimeEvent
,自動化程序執行的結構必須有在 Google Home app (GHA) 中設定的街道地址。變更 Google 住家地址一文說明使用者如何輸入建築物地址。如果未在 GHA 中設定地址,自動化程序將無法建立,且系統會擲回錯誤,並顯示「structure 不支援 ScheduledTimeEvent」訊息。 - 如要使用
AreaPresenceState
或AreaAttendanceState
特徵,使用者必須在 GHA 中設定在家狀態感應。 - 如要使用
ObjectDetection
特徵,使用者必須訂閱有效的 Nest Aware 方案。
- 如要使用
您也可以在自動化作業中使用部分特徵的簡化版本。 詳情請參閱「Android 簡化特徵」。
方塊表示自動化動作不支援一或多種裝置類型。詳情請參閱「Android 自動化動作中無法執行的動作」。