设备管理
字段路径以消息数组中的单个对象为起点。[] 表示数组元素,例如 services[].rid 表示每个服务的 rid;value 对象中的字段使用 value.name、value.color_arr[].x 等路径表示。
字段路径以消息数组中的单个对象为起点。[] 表示数组元素,例如 services[].rid 表示每个服务的 rid;value 对象中的字段使用 value.name、value.color_arr[].x 等路径表示。
一. 设备新增
1. topic
res/device/add
2. payload
json
[
{
"ext_button": [],
"ext_light": [],
"ext_sync": {},
"has_new": 0,
"id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
"join_status": 1,
"name": "Bar Lamp",
"new_version": "",
"online": 1,
"product": {
"cat1_id": 2,
"cat1_name": "Light",
"cat2_id": 205,
"cat2_name": "RGB CW Light",
"cat3_id": 20504,
"cat3_name": "Bar Lamp",
"hardware_version": "6",
"manufacturer": "Bweetech",
"model": "915005988001",
"software_version": "",
"zigbee_version": "4.11.11_50"
},
"services": [
{
"rid": "8BAD2C8A-38BE-41CB-A4D3-563B5C7E9C03",
"rtype": "light"
}
],
"type": "device"
}
]3. 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 设备的UUID |
type | string | 资源类型, 此处固定为 "device" |
name | string | 设备名称 |
join_status | integer | 入网状态, 此处必然为1 |
online | integer | 在线状态, 设备刚添加成功时必然为1 |
has_new | integer | 是否有新版本, 1有, 0没有 |
new_version | string | 新版本的版本号 |
product | object | 产品信息, 详见API文档 |
services | object[] | 服务列表 |
services[].rid | string | 资源UUID |
services[].rtype | string | 资源类型 |
ext_light | object[] | 灯具状态, 详见API文档 |
ext_sync | object | 同步器状态, 详见API文档 |
ext_button | object[] | 按键状态, 详见API文档 |
4. 功能说明
- 此topic会在设备入网后, 并且将 join_status 设置为1时 触发
二. 设备删除
1. topic
res/device/remove
2. payload
json
[
{
"id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
"type": "device"
}
]3. 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 设备唯一ID |
type | string | 资源类型, 此处固定为 "device" |
4. 功能说明
- 此topic会在设备删除, 或者设备 join_status 置为 0 时触发
三. 设备更新
1. topic
res/device/update
2. payload
json
[
{
"id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
"value": {
"name": "吧灯01"
}
}
]3. 字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 设备的 ID |
value | object | 有更新的字段 |
value对象
| 字段 | 类型 | 说明 |
|---|---|---|
value.name | string | 设备名称 |
value.room_id | string | 房间的UUID |
4. 功能说明
- 在设备信息变更时, 会触发此 topic
- value对象中, key存在代表有更新, key不存在代表未更新