智慧型住宅場景結構定義

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,用於取消情境。

範例

依名稱啟用情境。

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

依名稱停用情境。

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

裝置 ERRORS

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