Skip to content

房间管理

一. 房间新增

1. topic

res/room/add

2. payload
json
[
    {
        "id": "748670A4-EE28-4D08-B9A7-3D7F217A7E6B",
        "type": "room",
        "name": "主卧",
        "room_kind": 0,
        "room_type": "",
        "background": 1,
        "icon": "assets/room/room4.png",
        "sequence": 0,
        "children": [],
        "services": [
            {
                "rid": "B59EAB99-7D80-4AD2-8C2C-126ED7BED25F",
                "rtype": "group_light"
            }
        ]
    }
]

数组内元素为设备的UUID

3. 字段说明
序号字段类型说明
1idstring房间的UUID
2typestring资源类型, 此处固定为 "room"
3namestring房间名称
4room_kindint此处必然为0
5room_typestring房间类型, 未做限制, 可以是任意字符串
6sequenceint房间序号, 未做限制, 可以是任意数字
7childrenobject array此处必然是空数组
8servicesobject array支持的服务列表
8.[].1ridstring资源UUID
8.[].2rtypestring资源类型
9backgroundintBweeApp专用, 房间壁纸序号
10iconstringBweeApp专用, 房间壁纸名称
4. 功能说明
  • 此topic会在创建房间时 触发
  • 由于刚创建房间时没有设备, 所以报文中的 children 必然是空数组

二. 房间删除

1. topic

res/room/remove

2. payload
json
[
    {
        "id": "748670A4-EE28-4D08-B9A7-3D7F217A7E6B",
        "type": "room"
    }
]
3. 字段说明
序号字段类型说明
1idstring房间的UUID
2typestring资源类型, 此处固定为 "room"
4. 功能说明
  • 此topic会在房间删除时触发

三. 房间更新

1. topic

res/room/update

2. payload
json
[
    {
        "id": "748670A4-EE28-4D08-B9A7-3D7F217A7E6B",
        "value": {
            "name": "主卧(南)"
        }
    }
]
3. 字段说明
序号字段类型说明
1idstring房间的 ID
2valueobject有更新的字段

value对象

序号字段类型说明
1namestring房间名称
2room_typestring房间类型
3sequenceint房间序号
4backgroundint房间背景序号
5iconstring房间背景名称
6device_addstring array新增设备, 数组内元素为设备的UUID
7device_delstring array移除设备, 数组内元素为设备的UUID
4. 功能说明
  • 在房间信息变更时, 会触发此 topic
  • value对象中, key存在代表有更新, key不存在代表未更新