智慧型住宅場景特徵結構定義
action.devices.traits.Scene：此特徵用於與 SCENE 裝置類型一併實作虛擬裝置。
詳情請參閱場景類型指南。
舉例來說，如果裝置允許使用者設定一鍵指令群組，例如將燈光設為特定顏色、依序啟用各種安全性功能，或任何其他活動組合，這類設定可透過 SYNC 公開為命名的場景，Assistant 就會透過簡單的啟動語法，讓使用者使用這些場景：
- 啟動派對模式。
- 啟用午夜情境。
由於場景是虛擬物件，因此可放置在房間中 (如有必要) 以便區分：
- 在廚房開趴吧！
- 在臥室中啟用夜燈模式。
場景和實體目標之間的一個差異在於，Google 助理會自動將複數效果套用至場景指令，讓使用者在多個合作夥伴之間觸發場景。舉例來說，如果使用者在兩個不同的合作夥伴上設定「派對模式」情境 (一個用於安全性，另一個用於燈光)，則「啟用派對模式」會觸發這兩個情境。
場景將與即將推出的個人化動作互動，以便使用自訂文法 (例如「啟用派對模式」->「讓我們開趴吧！」)。
場景名稱一律應由使用者提供，而非預設的「BobCo Scene」。每個場景都是獨立的虛擬裝置，並有專屬名稱。使用者提供的名稱可能來自 SYNC。
裝置屬性
具備此特徵的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。
| 屬性 | 類型 | 說明 |
|---|---|---|
sceneReversible |
布林值 |
(預設值： 表示可取消此場景。這個屬性只適用於會修改狀態並記住先前狀態的場景。裝置支援 |
範例
支援可翻轉場景的裝置。
{
"sceneReversible": true
}裝置狀態
無。
裝置指令
具備此特徵的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱「意圖執行要求」。
action.devices.commands.ActivateScene
啟用或停用情境。
參數
| 參數 | 類型 | 說明 |
|---|---|---|
deactivate |
布林值 |
必填。 如果情境可取消，則傳回「是」；如果要啟用情境，則傳回「否」。 |
範例
依名稱啟用情境。
{
"command": "action.devices.commands.ActivateScene",
"params": {
"deactivate": false
}
}依名稱停用情境。
{
"command": "action.devices.commands.ActivateScene",
"params": {
"deactivate": true
}
}