智慧型住宅場景型結構定義
action.devices.traits.Scene：這個特性用於實作虛擬裝置以及 SCENE 裝置類型。
詳情請參閱場景類型指南。
舉例來說，如果裝置允許使用者設定一鍵指令的分組方式 (例如將燈光設為特定顏色、安排序列的安全性功能或其他任何活動組合)，則可透過 SYNC 以具名場景來呈現這項設定，而 Google 助理會透過簡單的啟用文法，向使用者提供以下情境：
- 啟動派對模式。
- 啟用午夜情境。
虛擬場景可以放置於房間 (如有相關) 中，以供釐清：
- 在廚房開始派對時間。
- 啟用臥室的夜間模式。
場景與實體目標的差別在於，Google 助理會自動為場景指令套用多重效果，讓使用者可在多個合作夥伴中觸發情境。例如，如果使用者在兩個不同的合作夥伴之間有「派對模式」情境，一個是安全性，另一個是燈具，則「啟用派對模式」會同時觸發兩者。
場景與自訂文法的「個人動作」互動時，就會產生良好的互動效果 (例如，啟用派對模式 -> 一起來開派對！)。
場景應使用使用者提供的名稱，而非預設的「BobCo 場景」命名。每個場景都是專屬的虛擬裝置，且具有專屬名稱。使用者提供的名稱可能來自 SYNC。
裝置屬性
具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求一文。
| 屬性 | 類型 | 說明 |
|---|---|---|
sceneReversible |
布林 |
(預設： 代表此場景可以取消。此屬性僅適用於修改狀態並記住先前的狀態的場景。裝置支援使用 |
範例
支援反向場景的裝置。
{
"sceneReversible": true
}
裝置狀態：STATE
無。
裝置指令
具有此特性的裝置可能會在 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
}
}