智慧型住宅場景結構定義

action.devices.traits.Scene - 這個特性的用途是搭配 SCENE 裝置類型來實作虛擬裝置。

詳情請參閱場景類型指南

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

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

做為虛擬物件,如有必要,可在房間內放置場景來消除歧義:

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

場景和實體目標的不同之處在於,Google 助理會自動對 Scene 指令套用複數效果,讓使用者觸發多個合作夥伴的場景。舉例來說,如果使用者在兩個不同的合作夥伴上有一個「派對模式」場景,一個用於安全防護和燈具,「啟用派對模式」就會觸發這兩個場景。

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

場景應一律使用使用者提供的名稱,而使用預設的「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
  }
}

裝置錯誤

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