新增【设备分组API】文档，可以对多个设备进行分组和控制
本帖最后由 Genius 于 2017-8-15 10:36 编辑定义：设备分组接口可以对多个设备进行分组，只要往分组里面发送指令，做到同时控制一个分组下的多个设备。
使用方式：要使用该设备分组接口，必须创建分组。创建分组以后根据MAC地址绑定设备，再根据设备日志MAC地址对应的did将设备加进一个分组里面，再往分组里面发送指令，设备收到指令并作出反应，就完成了设备分组。
举例说明：如：一个公司有多个部门，每个部门有多盏智能灯。每天早上一个部门来人了，就可以只打开该部门的智能灯。每天晚上一个部门的人都走光了，就可以只关闭该部门的智能灯。
设备分组API使用流程Open API的设备分组接口，就是对多个设备分组并进行控制。当开发者/企业用户开通openAPI设备分组接口使用权限后，就可以调用该接口把多个设备加入到分组，做到分组控制多个设备。（OPEN API 调用说明：http://docs.gizwits.com/zh-cn/Cloud/openapi_apps.html）
1.打开机智云官网文档中心->云API->OPEN API指南，下拉点击调试接口http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/1.pnghttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/2.png2.点击设备分组->创建分组http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/3.png3.点击创建分组->感叹号，填写App ID和token，这两个参数可以参考文档《利用openapi（postman）控制虚拟设备》中“2.3新建应用配置”和“3. Postman安装和导入”，参考文档链接http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/4.pnghttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/5.png4.填写App ID和token之后，填写bodyhttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/6.pnghttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/7.png5.得到分组id后，我们可以查看一下组里面有没有设备http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/8.pnghttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/9.png6.根据MAC绑定设备http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/10.pnghttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/11.pngTimestamp获取链接http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/12.pngSignature获取链接http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/13.png绑定设备成功以后会返回一个如下的响应体http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/14.png7.绑定设备以后，我们回到设备分组，将设备添加到分组http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/15.pnghttp://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/16.png8.查看设备日志http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/17.png9.成功添加设备到分组以后会返回如下响应体http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/18.png10.然后我们就可以针对设备分组发送指令远程控制设备http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/19.png11.这样我们就可以控制一个分组中的一个设备（RGB灯亮灭），按照同种方法添加多个设备到一个分组中，我们就可以同时控制一个分组中的多个设备。http://docs.gizwits.com/assets/zh-cn/UserManual/Dev_GroupAPI/20.png原文链接：http://docs.gizwits.com/zh-cn/UserManual/%E4%BD%BF%E7%94%A8%E8%AE%BE%E5%A4%87%E5%88%86%E7%BB%84API%E6%95%99%E7%A8%8B.html
页:
[1]