智能家居 StatusReport 特征架构

action.devices.traits.StatusReport - 此特征用于报告特定设备或一组已连接设备的当前状态。

特定设备可以报告其当前状态，以及组中任何相关设备的状态 。例如，目标设备可以是安全系统，相关设备 代表各个传感器。StatusReport 用于汇总报告集体状态，但不会取代单独寻址。任何可由 Google 助理访问的设备都应在 SYNC 响应中报告为单独的设备 。

设备属性

无。

设备状态

具有此特征的实体可能会报告以下 状态作为 QUERY 操作的一部分。如需详细了解如何处理 QUERY 意图，请参阅 意图执行。

状态	类型	说明
currentStatusReport	数组	必填。 设备和任何相关设备 ID 的当前错误或异常状态。
[item, ...]	对象	当前状态。
blocking	布尔值	如果错误或当前状态会阻止进一步的命令执行，则为 true。
deviceTarget	String	目标设备的 ID。
priority	整数	指定此状态的优先级。值越小，优先级越高，最高优先级为 0。Google 会按从高到低的优先级报告错误或异常状态。根据界面，Google 可能只会报告高优先级的错误或异常。 最小值：0。
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"
    }
  ]
}

设备命令

无。

设备错误

请参阅 错误和异常的完整列表。