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

智慧型住宅狀態報告特性結構定義

action.devices.traits.StatusReport - 這個特徵會回報特定裝置或已連結一組裝置的目前狀態,

特定裝置可以回報群組目前的狀態,以及群組中任何相關裝置的狀態。舉例來說,目標裝置可能是安全性系統,而相關裝置代表個別感應器。StatusReport 是匯總的回報收集狀態,但不會取代個別位址。凡是可透過 Google 助理存取的裝置,都必須在 SYNC 回應中回報為獨立的裝置。

裝置屬性

無。

裝置狀態:STATE

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

類型 說明
currentStatusReport 陣列

必填。

裝置目前的錯誤或例外狀況狀態,以及任何相關裝置 ID。

[item, ...] 物件

目前狀態。

blocking 布林

如果錯誤或目前狀態會封鎖後續指令,傳回 True。

deviceTarget 字串

目標裝置的 ID。

priority 整數

指定此狀態的優先順序。值越低,優先順序就越高,優先順序最高為 0。Google 會將錯誤或例外狀態回報給最高優先順序。視實際情況而定,Google 只能回報高優先順序的錯誤或例外情況。

statusCode 字串

裝置的目前狀態。請參閱錯誤和例外狀況的完整清單。

範例

我的安全系統還安全嗎?

{
  "currentStatusReport": [
    {
      "blocking": false,
      "deviceTarget": "alarm_1",
      "priority": 0,
      "statusCode": "lowBattery"
    },
    {
      "blocking": false,
      "deviceTarget": "front_window_1",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": false,
      "deviceTarget": "back_window_2",
      "priority": 1,
      "statusCode": "deviceOpen"
    },
    {
      "blocking": true,
      "deviceTarget": "alarm_2",
      "priority": 0,
      "statusCode": "needsSoftwareUpdate"
    }
  ]
}

裝置指令

無。

裝置錯誤:ERRORS

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