[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 ~~~