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