智能家居 StatusReport 特征架构
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"
}
]
}
设备命令
无。