智能家居 StatusReport 特征架构
action.devices.traits.StatusReport
- 此特征报告特定设备或一组已连接设备的当前状态。
特定设备可以报告其当前状态以及任何相关设备的状态
。例如,目标设备可能是具有相关设备的安防系统
分别表示各个传感器。StatusReport 用作
报告集体状态,但不会取代个别处理。
任何可通过 Google 助理访问的设备都应被报告为单独的设备
返回 SYNC
响应。
设备属性
无。
设备状态
具有此特征的实体可能会报告以下内容
QUERY
操作包含的指定状态。学习内容
有关处理 QUERY
intent 的更多信息,请参阅
intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
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" } ] }
设备命令
无。