智慧型住宅場景特徵

action.devices.traits.Scene：這個特徵可用於實作虛擬裝置與 SCENE 裝置類型。

詳情請參閱情境類型指南。

舉例來說，如果裝置允許使用者設定單點觸控分組 指令 — 將燈光設為特定顏色，或排定各種保全方式 功能或任何其他活動組合 — 這項設定可以 透過 SYNC 顯示為已命名的場景，Google 助理就會進行這些操作 透過簡單的啟用文法，向使用者顯示的場景：

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

做為虛擬物件，場景可以放置在房間內 (如有)， 消歧：

• 在廚房開始派對時間。
• 啟用臥室的夜燈模式。

場景和身體目標的差異之一是 Google 助理會 自動將複數效果套用至 Scene 指令，讓使用者觸發 有多個夥伴的場景舉例來說，如果使用者採用「派對模式」兩個場景 分別用於安全和燈具，以及啟用派對模式 兩者都會觸發

場景適合與即將到來的「個人化動作」互動，可自訂文法 (例如「啟用派對模式」->「讓我們開始派對吧！」)。

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

裝置屬性

具備這項特徵的裝置可能會回報下列資料： 在 SYNC 作業中使用屬性變更。學習 如要進一步瞭解如何處理 SYNC 意圖，請參閱 意圖執行要求。

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

範例

支援可逆反轉場景的裝置。

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

裝置錯誤

查看完整清單 錯誤和例外狀況。