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

action.devices.traits.Scene - 這個特徵可用來搭配 SCENE 裝置類型實作虛擬裝置。

詳情請參閱場景類型指南

舉例來說,如果裝置允許使用者設定單點觸控分組指令 (例如將燈光設為特定顏色、排序各種安全性功能或任何其他活動組合),則可透過 SYNC 以已命名的「情境」的形式公開這項設定,而 Google 助理會透過簡單的文法啟動,向使用者提供這些場景:

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

場景是虛擬物件,可置於房間 (如有必要) 中呈現,以便區分:

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

情境和實體目標的一項差異在於,Google 助理會自動為場景指令套用複數效果,讓使用者觸發多個合作夥伴的場景。例如,如果使用者在兩個不同的合作夥伴都設有「派對模式」場景,其中一個用於安全性,另一個用於燈光,啟用派對模式就會同時觸發這兩個模式。

場景會針對自訂文法,與即將推出的個人動作相容 (例如,「Activate Party Mode」(啟用派對模式) ->「Let's started the party started!」)。

場景應一律採用使用者提供的名稱,而非預設的「BobCo Scene」命名。每個場景都是具有專屬名稱的虛擬裝置。使用者提供的名稱可能來自 SYNC

裝置特徵

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

屬性 類型 說明
sceneReversible 布林值

(預設值:false)

表示可以取消這個場景。這項屬性僅適用於修改狀態和記住先前狀態的場景。裝置支援將 deactivate 參數設為 true 的 ActivateScene 指令。

範例

支援可復原場景的裝置。

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

裝置錯誤

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