海康萤石云接入

最近有需求需要接入海康的萤石云平台，api众多呀，所以挑重点记录一下接入过程

1. 接入指南 就是个步骤，注册成为开发者，完成认证，有条件的买个企业的版就行了。一步一步走完就没啥问题了

   https://open.ys7.com/bbs/article/56

2. 设备设置指南，这个分两步

   https://open.ys7.com/bbs/article/34

   第一步 激活的话，官网上要下那个sadp那个软件，这个比较坑了，下面里面这个文档里的地址竟然是404，只要找其他了，用下面这个密码重置助手也可以激活
   
   第二步 添加设备的话，可以让硬件人员直接扫码即可，也可以通过接口添加，响应的key和secret以及accessToken在开发者平台的 我的账号 》应用信息里找
   
   萤石云设置的话，有一些注意的

   1. 中间的接入ip，不用改的，暂时没遇到需要改的
   2. 初始验证码必须修改
   3. 设备的序列号是出场就固定好的调用接口的时候，需要看密码重置助手选中当前设备右侧出现的短序列号
      

3. 常见错误的api

   https://open.ys7.com/bbs/article/56
   不出意外的话第一次接入查看设备列表的直播地址会报9057的错误，这个里面会有解决方式
   

4. 常用api
   因为我们只有看监控视频和云台控制的需求，所以先将相关接口记录如下：

   1. 从萤石云获取直播流地址
      https://open.ys7.com/doc/zh/book/index/address_v2.html
   2. 云台控制 开始与结束
      https://open.ys7.com/doc/zh/book/index/device_ptz.html
      
   3. 获取设备列表 等
      https://open.ys7.com/doc/zh/book/index/device_select.html#device_select-api1

完事，齐活了