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