场景管理

一. 场景新增

1. topic

res/scene/add

2. payload

[
    {
        "id": "AE017B91-75BF-4CC6-9EC7-F2C48DDC11FD",
        "type": "scene",
        "name": "瓦尔登湖",
        "parent_id": "2F0B3B6D-CE40-4A2F-A529-A2DE3EDD9C62",
        "parent_type": "group_light",
        "room_uuid": "6B703F4A-A2A2-4F3C-82D6-BDD4E8BA8B1C",
        "brightness": 0,
        "scene_type": 2,
        "is_active": 0,
        "sequence": 0,
        "number": 4885848,
        "icon": "",
        "background": "",
        "colors": [
            4293473571,
            4293687116,
            4294026836,
            4294432128,
            4287352825
        ],
        "picture_id": "25967925-FC78-4C1F-A8CB-33E5A3DD17A5",
        "picture_type": "file",
        "picture_url": "http://192.168.41.104:8000/33E5A3DD17A5.png",
        "device_arr": [
            {
                "ext_light": [],
                "id": "10E48D35-0ABD-47EB-BA4B-C150D68C4B23",
                "type": "device"
            }
        ]
    }
]

数组内元素为设备的UUID

3. 字段说明

序号	字段	类型	说明
1	id	string	场景的UUID
2	type	string	资源类型, 此处固定为 "scene"
3	name	string	场景名称
4	parent_id	string	父节点, 即group_light 的UUID
5	parent_type	string	此处固定为 group_light
6	room_uuid	string	房间的UUID
7	brightness	int	场景的亮度
8	scene_type	int	1颜色场景, 2图片场景
9	is_active	int	是否激活, 1是, 0否
10	sequence	int	场景序号
11	number	int	场景库的编号
12	icon	string	场景图标, 实际没用到
13	background	string	场景背景, 实际没用到
14	colors	int array	场景5个颜色
15	picture_id	string	图片资源的UUID
16	picture_type	string	此处固定为 file
17	picture_url	string	图片的URL
18	device_arr	object array	场景中每个设备的颜色, 详见API文档

4. 功能说明

• 此topic会在创建场景时 触发

---

二. 场景删除

1. topic

res/scene/remove

2. payload

[
    {
        "id": "AE017B91-75BF-4CC6-9EC7-F2C48DDC11FD",
        "type": "scene"
    }
]

3. 字段说明

序号	字段	类型	说明
1	id	string	场景的UUID
2	type	string	资源类型, 此处固定为 "scene"

4. 功能说明

• 此topic会在场景删除时触发

---

三. 场景更新

1. topic

res/scene/update

2. payload

[
    {
        "id": "AE017B91-75BF-4CC6-9EC7-F2C48DDC11FD",
        "room_id": "6B703F4A-A2A2-4F3C-82D6-BDD4E8BA8B1C",
        "value": {
            "is_active": 1
        }
    }
]

3. 字段说明

序号	字段	类型	说明
1	id	string	场景的 UUID
2	room_id	string	房间的 UUID
3	value	object	有更新的字段

value对象

序号	字段	类型	说明
1	name	string	场景名称
2	picture_id	string	图片UUID
3	picture_type	string	此处固定为 file
4	picture_url	string	图片的 URL
5	sequence	int	场景序号
6	icon	string	场景图标
7	background	string	场景背景图
8	colors	int array	场景的5个颜色
9	is_active	int	场景激活状态, 1激活, 0未激活

4. 功能说明

• 在场景信息变更时, 会触发此 topic
• value对象中, key存在代表有更新, key不存在代表未更新