[TOC=2]
## 情景列表
~~~[api]
get:/project_group_scene/list
*integer:group_id=0#分组 id
integer:current_page=0#当前页
integer:page_number=0#页码
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 27,
"group_id": 186,
"name": "aaa",
"configs": [
{
"type": 0,
"src_sn": "840354001003",
"src_act": {
"sw1": false
},
"bind_dev": [
{
"dst_sn": "840354001003",
"dst_act": {
"sw1": true
},
"device_id": 15358
}
],
"device_id": 15358,
"src_name": "本地桌面"
}
],
"create_time": "2022-05-05 11:09:54"
}
],
"current_page": 0,
"page_number": 0,
"total": 1
}
}
<<<
explain
id // 情景 id(更新、删除用)
group_id // 分组 id
name // 情景名称
create_time // 创建时间
configs // 具体配置 这里是数组,可以存放多个设备状态配置
type // 配置类型 0 情景 1 联动
src_sn // 源设备序列号 --> 发现设备动作时候的设备序列号
src_name // 设备名称
src_act // 源设备动作 --> 开关机等
device_id // 设备对应的 id (在发现设备接口可以返回)
bind_dev // 绑定的设备等
dst_sn // 目标设备序列号 ---》 点设备后的设备列表所选择的设备
device_id // 设备对应的 id
dst_act // 对应执行的动作
current_page // 当前页
page_number // 页码
total // 总条数
<<<
error
~~~
## 情景搜索
~~~[api]
get:/project_group_scene/search
*integer:group_id=0#分组 id
*string:search=""#搜索内容 仅支持情景名称
integer:current_page=0#当前页
integer:page_number=0#页码
<<<
<<<
success
{
"code": 0,
"data": {
"list": [
{
"id": 27,
"group_id": 186,
"name": "aaa",
"configs": [
{
"type": 0,
"src_sn": "840354001003",
"src_act": {
"sw1": false
},
"bind_dev": [
{
"dst_sn": "840354001003",
"dst_act": {
"sw1": true
},
"device_id": 15358
}
],
"device_id": 15358,
"src_name": "本地桌面"
}
],
"create_time": "2022-05-05 11:09:54"
}
],
"current_page": 0,
"page_number": 0,
"total": 1
}
}
<<<
explain
和列表数据解析一致
<<<
error
~~~
## 情景创建(更新)
~~~[api]
post:/project_group_scene/save
integer:id=0#情景id(大于 0 更新操作,小于等于或者无该字段新增)
*integer:group_id=0#分组 id(分组列表内的 id 值)
*string:name=""#情景名称 2 ~ 16 个字符
*josn:configs={}#具体配置信息
<<<
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "名称不能为空",
"message": "名称不能为空"
}
~~~
>[danger] configs 为数组形式的
> 一层字段 src_sn 目标选择的 设备序列号 (必填)
> 一层字段 src_act 目标设备的动作 (必填)
> bind_dev 绑定关联的设备 (必填) 数组形式
> 二层 bind_dev 内的字段 dst_sn 选择的设备序列号(必填)
> 二层 bind_dev 内的字段 dst_act 选择设备的动作(必填)
> 二层 bind_dev 内的 device_id 设备列表的 device_id (必填)
> 其他页面要显示的内容可以随意添加字段,比如加设备名称等
## 情景删除
~~~[api]
post:/project_group_scene/delete
*array:id_list=[1]#情景列表 id 值数组
*integer:group_id=0#分组 id
<<<
<<<
success
{
"code": 0
}
<<<
error
{
"code": -1,
"msg": "操作项不能为空",
"message": "操作项不能为空"
}
~~~
## 情景配置下发
~~~[api]
post:/device_status/set_group_scene
*integer:project_id=0#项目 id
*integer:group_id=0# 分组 id
<<<
<<<
success
调用之后可以不管结果。 给个提示让测试就行
<<<
error
~~~