智慧型住宅場景特徵結構定義

action.devices.traits.Scene：此特徵用於與 SCENE 裝置類型一併實作虛擬裝置。

詳情請參閱場景類型指南。

舉例來說，如果裝置允許使用者設定一鍵指令群組，例如將燈光設為特定顏色、依序啟用各種安全性功能，或任何其他活動組合，這項設定可透過 SYNC 公開為命名的場景，Assistant 就會透過簡單的啟動語法，讓使用者使用這些場景：

• 啟動派對模式。
• 啟用午夜場景。

由於場景是虛擬物件，因此可放置在房間中 (如有必要) 以便區分：

• 在廚房開趴吧！
• 啟用臥室的夜燈模式。

場景和實體目標之間的一個差異在於，Google 助理會自動將多重效果套用至場景指令，讓使用者在多個合作夥伴之間觸發場景。舉例來說，如果使用者在兩個不同的合作夥伴上設定「派對模式」情境 (一個用於安全性，另一個用於燈光)，則「啟用派對模式」會觸發這兩個情境。

場景將與即將推出的個人化動作互動，以便使用自訂文法 (例如「啟用派對模式」->「讓我們開趴吧！」)。

場景名稱一律應由使用者提供，而非預設的「BobCo Scene」。每個場景都是獨立的虛擬裝置，並有各自的名稱。使用者提供的名稱可能來自 SYNC。

裝置屬性

具備此特徵的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖執行要求」。

屬性	類型	說明
sceneReversible	布林值	(預設值：false) 表示這個場景可以取消。這項屬性僅適用於修改狀態並記住先前狀態的場景，裝置支援 ActivateScene 指令，並將 deactivate 參數設為 true。

範例

支援可翻轉場景的裝置。

{
  "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
  }
}

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。