欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

智能家居状态报告特征架构

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

特定设备可以报告其当前状态以及组中任何相关设备的状态。例如,目标设备可能是安防系统,而相关设备代表各个传感器。StatusReport 充当集合报告状态的汇总,但不会替代单个寻址。 任何可供 Google 助理访问的设备都应在 SYNC 响应中报告为一个单独的设备。

设备属性

无。

设备状态

具有此特征的实体可能会在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent,请参阅 intent 执行方式

类型 说明
currentStatusReport 数组

必填。

设备当前的错误或异常状态,以及任何相关设备 ID。

[item, ...] 对象

当前状态。

blocking Boolean

如果错误或当前状态阻止后续命令执行,则为 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"
    }
  ]
}

设备命令

无。

设备出错

查看错误和异常的完整列表。