智慧型住宅場景特徵結構定義
action.devices.traits.Scene
- 這個特徵可用來搭配 SCENE 裝置類型實作虛擬裝置。
詳情請參閱場景類型指南。
舉例來說,如果裝置允許使用者設定單點觸控分組指令 (例如將燈光設為特定顏色、排序各種安全性功能或任何其他活動組合),則可透過 SYNC
以已命名的「情境」的形式公開這項設定,而 Google 助理會透過簡單的文法啟動,向使用者提供這些場景:
- 開始派對模式。
- 啟用午夜場景。
場景是虛擬物件,可置於房間 (如有必要) 中呈現,以便區分:
- 在廚房開始派對時間。
- 在臥室啟用夜間模式。
情境和實體目標的一項差異在於,Google 助理會自動為場景指令套用複數效果,讓使用者觸發多個合作夥伴的場景。例如,如果使用者在兩個不同的合作夥伴都設有「派對模式」場景,其中一個用於安全性,另一個用於燈光,啟用派對模式就會同時觸發這兩個模式。
場景會針對自訂文法,與即將推出的個人動作相容 (例如,「Activate Party Mode」(啟用派對模式) ->「Let's started the party started!」)。
場景應一律採用使用者提供的名稱,而非預設的「BobCo Scene」命名。每個場景都是具有專屬名稱的虛擬裝置。使用者提供的名稱可能來自 SYNC
。
裝置特徵
具有此特徵的裝置可能會在執行 SYNC
作業時回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱「意圖執行要求」。
屬性 | 類型 | 說明 |
---|---|---|
sceneReversible |
布林值 |
(預設值: 表示可以取消這個場景。這項屬性僅適用於修改狀態和記住先前狀態的場景。裝置支援將 |
範例
支援可復原場景的裝置。
{ "sceneReversible": true }
裝置狀態
無。
裝置指令
具備此特徵的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱「意圖執行要求」。
action.devices.commands.ActivateScene
啟用或停用場景。
參數
參數 | 類型 | 說明 |
---|---|---|
deactivate |
布林值 |
必要。 設為 True 表示可以復原場景,設為 false 則可啟動場景。 |
範例
依名稱啟用場景。
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
依名稱停用場景。
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }