智慧型住宅場景結構定義
action.devices.traits.Scene
- 這個特性的用途是搭配 SCENE 裝置類型來實作虛擬裝置。
詳情請參閱場景類型指南。
舉例來說,如果裝置允許使用者設定單點觸控分組的指令 (例如將燈光設定為特定顏色、將各種安全性功能設為序列,或任何其他活動組合),這項設定就能透過 SYNC
以已命名的「情境」公開,而 Google 助理會透過簡單的啟動文法,向使用者提供這些場景:
- 啟動派對模式。
- 啟用午夜場景。
做為虛擬物件,如有必要,可在房間內放置場景來消除歧義:
- 在廚房開始派對時間。
- 啟用臥室的夜間模式。
場景和實體目標的不同之處在於,Google 助理會自動對 Scene 指令套用複數效果,讓使用者觸發多個合作夥伴的場景。舉例來說,如果使用者在兩個不同的合作夥伴上有一個「派對模式」場景,一個用於安全防護和燈具,「啟用派對模式」就會觸發這兩個場景。
場景會與即將推出的自訂文法個人動作互動 (例如「Activate Party Mode」(啟用派對模式) ->「Let's get the Party!」(開始開派對!))。
場景應一律使用使用者提供的名稱,而使用預設的「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 } }