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

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

特定裝置可以回報目前的狀態,以及所有相關裝置的狀態 群組舉例來說,目標裝置可能是含有相關裝置的保全系統 分別代表個別感應器StatusReport 匯總了 但不能取代個別地址。 請將 Google 助理可存取的任何裝置回報為個別裝置 SYNC回應中。

裝置屬性

無。

裝置狀態

具有此特徵的實體可能會回報下列資料: 做為 QUERY 作業的一部分。學習 如要進一步瞭解如何處理 QUERY 意圖,請參閱 意圖執行要求

類型 說明
currentStatusReport 陣列

必要。

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

[item, ...] 物件

目前狀態。

blocking 布林值

如果錯誤或目前狀態封鎖了進一步的指令執行,則為「true」。

deviceTarget String

目標裝置的 ID。

priority 整數

指定這個狀態的優先順序。值越小,優先順序越高,優先順序最高為 0。Google 會依優先順序由高至低迴報錯誤或例外狀況狀態。視途徑而定,Google 可能只會回報優先順序較高的錯誤或例外狀況。

statusCode String

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

範例

我的保全系統還可以嗎?

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

裝置指令

無。

裝置錯誤

查看完整清單 錯誤和例外狀況