获取摄像机视频播放 WebSDK 链接
接口功能
获取摄像机视频播放 WebSDK 链接，调用 WebSDK 播放视频。
重要说明
收费说明：调用该接口，请确保接口调用次数和监控集成服务包路数均充足
扣除说明：调用本接口一次，若设备 ID 是本月首次请求，将扣除接口调用次数 1 次、扣除监控集成服务包路数 1 路；若设备 ID 是本月重复请求的，仅扣除接口调用次数 1 次；
重置说明：每月末清空已请求的设备 ID 列表；每月 1 号起，应用下已请求设备 ID 列表为空，重新记录。
- PC 端集成建议操作系统 windows10 以上，浏览器 chrome 117 以上
- WebSdk H5 兼容性上，已支持设备型号为 A21（本处指新增，默认接入视联网底座，历史设备请单独咨询），其他两款型号即将支持
- 其他设备是指不属于视联网设备的其他 IPC 设备（不包含非视频类设备）
- 小程序 H5 页面集成方案、半屏/跳转方案均不支持
请求地址
https://open.qly.cmviot.cn/v3/open/api/websdk/player请求方式
POST，需要鉴权
请求参数
| 参数名称 | 参数类型 | 是否必需 | 参数含义 | 说明 |
|---|---|---|---|---|
| deviceId | String | Y | 设备 ID | |
| endTime | long | N | 失效时间 | 大于当前时间的 13 位毫秒时间戳 |
请求示例
{"deviceId":"xxxxS_de16b0","endTime":1567146061000}响应参数
| 参数名称 | 参数类型 | 参数含义 | 说明 |
|---|---|---|---|
| resultCode | String | 响应码 | 参考响应码定义 |
| resultMsg | String | 响应描述 | |
| data | object | 响应数据 |
data 数据模型
| 名称 | 类型 | 说明 | 备注 |
|---|---|---|---|
| url | String | 拉取直播流的 url | 使用一次或到达失效时间后失效 |
| expiresIn | int | 链接失效时间 | 单位：秒 |
响应示例
{
"resultCode": "000000",
"resultMsg": "成功",
"data": {
"expiresIn": 300,
"url": "http://open.qly.cmviot.cn/websdk/player/47abe8367a7b2a8ca093cffa2c59ba91"
}
}WebSdk 播放器页面在电脑端浏览器上的功能说明
| 功能名称 | 默认支持 | 功能依赖 | 备注 |
|---|---|---|---|
| 直播 | 均支持 | 设备在线 | 访问本链接，便进入直播模式 |
| 直播-云台控制-上下左右 | 需设备支持云台功能 | 设备在线且支持本能力 | 国标设备均展示该控件，千里眼私有协议设备的话，不具备本能力的不展示云台控件 |
| 直播-云台控制-缩放变倍 | 需设备支持本能力 | 设备在线且支持本能力 | 仅国标设备均展示该控件（是否生效以设备能力为准） |
| 直播-云台控制-焦距调节 | 需设备支持本能力 | 设备在线且支持本能力 | 仅国标设备均展示该控件（是否生效以设备能力为准） |
| 直播-云台控制-光圈调节 | 需设备支持本能力 | 设备在线且支持本能力 | 镜头光圈调节，仅国标设备均展示该控件（是否生效以设备能力为准） |
| 直播-云台控制-预置点设置 | 需设备支持本能力 | 设备在线且支持本能力 | 支持查看预置点、新增、编辑、删除预置点 仅国标设备均展示该控件（是否生效以设备能力为准） |
| 直播-云台控制-巡航路线 | 需设备支持本能力 | 设备在线且支持本能力 | 支持查看、新增、编辑、删除。 仅国标设备均展示该控件（是否生效以设备能力为准） |
| 直播-语音对讲 | 需设备支持本能力 | 设备在线且支持本能力 | 国标设备均展示该控件，千里眼私有协议设备的话，不具备能力则不展示 |
| 直播-清晰度切换 | 需设备支持本能力 | 设备在线且支持本能力 | 可切换高清、标清，国标设备均展示该控件，千里眼私有协议设备的话，不具备能力则不展示 |
| 录像文件列表-云存 | 均支持 | 设备绑定云存套餐 | 默认云存，若设备无云存，尝试播放设备本地存储 |
| 录像文件列表-本地存储 | 需设备支持该项能力 | 设备支持本地存储 | 本地存储若无文件，则播放器进度条无录像文件，可再切回云存 |
| 录像文件-告警片段 | 需有告警数据 | 设备绑定 AI 套餐或是智能终端 | |
| 录像-时间轴间隔 | 均支持 | 设备有存储数据 | 回放时间轴显示的时间跨度，包含 5 分钟、1 个小时、24 小时，3 种不同时间跨度 |
| 录像-倍速播放 | 云存支持，本地存储不支持 | 回看云存文件时，展示本控件 | 回看云存时，默认 1 倍速，支持有：0.5、1、2、4、8、16、32 |
| 声音开/关 | 均支持 | 均支持 | 播放器上的声音开关 |
| 画面缩放 | 均支持 | 均支持 | 最大支持放大到 5 倍 |
| 全屏 | 均支持 | 均支持 | |
| 截图 | 均支持 | 均支持 |
千里眼私有协议-不支持对讲的设备,在电脑端浏览器访问 WebSdk 播放器，如下图： 
国标协议的设备,在电脑端浏览器访问 WebSdk 播放器，如下图： 
WebSdk 播放器页面在移动端浏览器上的功能说明
移动端画面空间有限，需要更多控件时，请手机横屏（务必关闭【竖排方向锁定】）。
| 功能名称 | 说明 | 横屏是否支持 | 竖屏是否支持 |
|---|---|---|---|
| 直播 | 访问本链接，便进入直播模式 | 支持 | 支持 |
| 直播-云台控制-上下左右 | 国标设备均展示该控件，千里眼私有协议设备的话，不具备本能力的不展示云台控件 | 支持 | 不支持 |
| 直播-语音对讲 | 国标设备均展示该控件，千里眼私有协议设备的话，不具备能力则不展示 | 支持 | 不支持 |
| 直播-清晰度切换 | 可切换高清、标清，国标设备均展示该控件，千里眼私有协议设备的话，不具备能力则不展示 | 支持 | 不支持 |
| 录像文件列表-云存 | 默认云存，若设备无云存，尝试播放设备本地存储，支持切本地存储 | 支持 | 支持（仅看，切本地需横屏） |
| 录像文件列表-本地存储 | 本地存储若无文件，则播放器进度条无录像文件 | 支持 | 不支持 |
| 录像文件-告警片段 | 设备有告警数据，录像文件以明显颜色标记事件位置，设备需绑定 AI 套餐或是智能终端，并上报告警 | 支持 | 支持 |
| 声音开/关 | 均支持 | 均支持 | 播放器上的声音开关 |
| 全屏 | 均支持 | 均支持 | |
| 直播-云台控制-缩放 | 仅国标设备，才展示该控件（是否生效以设备能力为准） | 支持 | 不支持 |
| 直播-云台控制-焦点 | 仅国标设备，才展示该控件（是否生效以设备能力为准） | 支持 | 不支持 |
| 直播-云台控制-光圈调节 | 仅国标设备，才展示该控件（是否生效以设备能力为准） | 支持 | 不支持 |
| 直播-云台控制-步长调节 | 仅国标设备，才展示该控件（是否生效以设备能力为准）。务必确认，您的终端，是否具备该能力。 步长决定了云台在每次按键操作时移动的单位距离或角度，数值越大，云台移动的速度越快 | 支持 | 不支持 |
国标设备，在移动端浏览器访问 WebSdk 播放器，横屏如下图： 
国标设备，在移动端浏览器访问 WebSdk 播放器，竖屏如下图： 