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