智慧型住宅場景結構定義
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
}
}