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