UIKIT

1.概述

UIKit是一款具备专业属性的播放器，只需使用一个链接就可以嵌入你的应用，就好比在PPT里插入高级动画，而这个动画正是你的观众最关注的场景。
具有以下丰富的功能：视频名称的展示，截图，录制，全屏，预览回放的切换，清晰度切换，电子放大。

但是，需要注意的是：
UIkit集成方案依赖浏览器解码，对性能消耗较大，建议同时播放不超过1个，且设备需要降低码流参数配置（分辨率：720P 帧率：15 码流：1M 视频设备参数配置指南），否则可能导致浏览器崩溃或视频画面卡顿等现象。

浏览器兼容：Chrome、Firefox、最新版的Edge。

2.术语

术语	说明
视频名称	对应设备名称，可通过控制台或接口修改，可用于设备与视频的管理。
截图	抓取播放器当前画面，以jpeg的格式保存到本地，可直接查看。
录制	抓取播放器播放过程中的一段视频，以mp4的格式保存到本地，需下载指定播放器进行查看。
全屏	可通过双击视频或点击全屏按钮进行全屏观看，按esc键可取消全屏。
预览回放的切换	一个播放器可同时预览与回放，选择不同的时间与回放源进行播放，更加灵活。
清晰度切换	预览模式下可以切换高清与流畅视频源，满足不同清晰度的诉求。
电子放大	根据需要可以针对视频中的部分区域放大观看，按住鼠标往右下方滑动是放大，往左上方滑动是缩小。
设备序列号	即注册设备接口中deviceSerial字段值，一般为9位包含字母或数字的字符串。
通道号	即查询设备下通道列表接口中channelNo字段值，一般为1/2/3等数字。

3.开始对接

对接安防版UIkit无需下载任何控件，仅需要按照该文档对接即可。

3.1 Web集成

3.1.1 示例
预览：

回放：

3.1.2 详细说明
Web接入是通过iframe嵌入网址https://open.ys7.com/ezopen/h5/iframe_se，并在网址后携带以下参数，如下：

参数名称	说明
url	监控地址，规则见表下方说明
autoplay	1-开启自动播放，未显示字段-关闭自动播放
audio	1-开启音频，未显示字段-关闭音频
accessToken	即取流认证接口返回的token，播放监控地址的必要参数，获取视频取流认证token
begin/end	按照时间区间回放录像，值格式：yyyyMMddhhmmss

**重要：**如果播放失败，可能是该设备已被加密，请关闭设备视频加密，或在ezopen地址中加入设备的验证码，加入示例如下url

其中url规则如下：
预览：ezopen:// [设备验证码@] open.ys7.com/[deviceSerial]/[channelNo] [.hd].live
地址示例：ezopen://验证码@open.ys7.com/456789123/1.hd.live

回放：

ezopen:// [设备验证码@] open.ys7.com/[deviceSerial]/[channelNo] [.hd].rec[?begin= yyyyMMddhhmmss&end= yyyyMMddhhmmss]

地址示例：ezopen://验证码@open.ys7.com/456789123/1.rec?begin=20190317000000&begin=20190317235959

参数名称	说明
deviceSerial	即设备序列号，含义见本文第2章节术语表
channelNo	即通道号，含义见本文第2章节术语表
清晰度	.hd对应高清，不传对应流畅
预览/回放模式	.live对应预览，.rec对应回放

3.2 H5集成

3.2.1 示例

https://open.ys7.com/ezopen/h5/live?audio=1&accessToken=at.8fdi08no85t2bfkw493l6im6bg7ilwy2-9guiyp58c1-18m751o-g9ndqalhs&hd=1&deviceSerial=203751922&channelNo=1

3.2.2 详细说明
H5接入是跳转到网址https://open.ys7.com/ezopen/h5，并在网址后携带以下参数，在新开页播放视频的方式

参数名称	说明
预览/回放方式	/live对应预览，/rec对应回放
audio	1-开启音频，未显示字段-关闭音频
accessToken	即取流认证接口返回的token，播放监控地址的必要参数，获取视频取流认证token
validCode	验证码，加密设备播放需要验证码，一般为6位字母组成的字符串。
hd	1-高清（实际为主码流），未显示字段-流畅（实际为子码流）
deviceSerial	设备序列号，含义见本文第2章节术语表。
channelNo	通道号，含义见本文第2章节术语表。
recType	回放源： 2-本地存储
begin/end	按照时间区间回放录像，仅支持指定到日期，值格式：yyyyMMdd

1.概述#

2.术语#

3.开始对接#

3.1 Web集成#

3.2 H5集成#

1.概述

2.术语

3.开始对接

3.1 Web集成

3.2 H5集成