歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

action.devices.traits.Scene:這個特性用於實作虛擬裝置以及 SCENE 裝置類型。

詳情請參閱場景類型指南

舉例來說,如果裝置允許使用者設定一鍵指令的分組方式 (例如將燈光設為特定顏色、安排序列的安全性功能或其他任何活動組合),則可透過 SYNC 以具名場景來呈現這項設定,而 Google 助理會透過簡單的啟用文法,向使用者提供以下情境:

  • 啟動派對模式。
  • 啟用午夜情境。

虛擬場景可以放置於房間 (如有相關) 中,以供釐清:

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

場景與實體目標的差別在於,Google 助理會自動為場景指令套用多重效果,讓使用者可在多個合作夥伴中觸發情境。例如,如果使用者在兩個不同的合作夥伴之間有「派對模式」情境,一個是安全性,另一個是燈具,則「啟用派對模式」會同時觸發兩者。

場景與自訂文法的「個人動作」互動時,就會產生良好的互動效果 (例如,啟用派對模式 -> 一起來開派對!)。

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

裝置屬性

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

屬性 類型 說明
sceneReversible 布林

(預設:false)

代表此場景可以取消。此屬性僅適用於修改狀態並記住先前的狀態的場景。裝置支援使用 deactivate 參數為 true 的 ActivateScene 指令。

範例

支援反向場景的裝置。

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

裝置錯誤:ERRORS

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