1 Star 4 Fork 0

D_调 / EZUIKit-JavaScript

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

UIKit JavaScript使用文档

一、简介

UIKit,是基于萤石开放平台OpenSDK封装的UI组件,使用过程中不必学习专业的业务概念,更不用调用繁琐的接口,能够以极简的嵌入方式,快速在您的应用中集成视频功能。

UIKit JavaScript是用于WEB端,移动H5端的JavaScript插件,使用UIKit JavaScript,您可以:

  • 轻松实现视频直播功能,包含HLS,RTMP,FLV,WS格式流媒体实时播放。
  • 轻松实现Web端预览,回放功能。

二、获取UIKit JavaScript

1.下载

最新版

git clone https://github.com/Hikvision-Ezviz/EZUIKit-JavaScript.git

旧版本下载

请前往开放平台官网下载

2.引入

本地引入

<script src="{{location path}}/ezuikit.js">/ezuikit.js</script>

页面引入

<script src="https://open.ys7.com/sdk/js/1.4/ezuikit.js"></script>

ps : 页面引入方式适用直播场景,预览和回放功能实现原理为本地解码,需要本地引入的方式加载本地解码库

三、示例

环境准备:需确认本地80端口未被占用

注意:开发时需将包放到服务器上,不支持引用。

四、直播

1.页面创建video标签

<video
  id="myplayer"
  src="ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.live"
  width="400"
  height="300"
  poster="[这里可以填入封面图片URL]"
  [autoplay]
  controls
  playsInline
  webkit-playsinline
>
</video>

配置说明:

属性名 示例 默认值 说明
id myPlayer null *必填,video标签id
src ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.live null 直播地址
支持ezopen协议格式(推荐)
支持HLS,RTMP,FLV,m3u8等任意格式直播地址
autoplay true false 是否自动播放
poster 图片url null 封面图片地址
width 400 null 视频元素宽度
height 400 null 视频元素高度

2.初始化

<script>
  var player = new EZUIPlayer('myPlayer');
</script>

3.方法集

  • 直播播放

    player.play()

  • 直播停止

    player.stop()

五、预览,回放

1.页面创建div标签

  <div id="myPlayer"></div>

2.初始化

 var player = new EZUIPlayer({
      id: 'myPlayer',
      url: url,
      autoplay: true,
      accessToken: "at.8o2k6dbpcvtr13reaa96hbnya6fee2wf-9gu6zcjmh2-1j4yrsb-imvlc5poc",
      decoderPath: '{{location path}}',
      width: 600,
      height: 400,
    });

配置说明:

属性名 示例 默认值 说明
id myPlayer null *必填,元素标签id
url ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.live null 直播地址
支持ezopen协议格式(推荐)
支持ws, wss格式预览地址播放
多窗口模式请用英文逗号(,)分隔
accessToken "at.8o2k6dbpcvtr13reaa96hbnya6fee2wf-9gu6zcjmh2-1j4yrsb-imvlc5poc" null 用户通过官网或者接口获取的accessToken
decoderPath 解码器相对路径 null *必填,预览需要本地加载解码器,请填写ezuikit所在相对路径
width 400 null 视频元素宽度
height 400 null 视频元素高度
autoplay true true 是否自动播放
splitBasis 1 1 多窗口设置窗口切割参数
handleError null null 错误回调方法,用于捕获错误

3.方法集

  • 预览,回放开始播放

    player.play()

  • 预览,回放停止

    player.stop()

3.多窗口模式

支持 1*1,2*2,3*3,4*4 多窗口播放

实现多窗口仅需两步:

  • 设置窗口切割参数(1*1,2*2,3*3,4*4) splitBasis
  • 多窗口url通过逗号分隔
    var player = new EZUIPlayer({
        id: 'myPlayer',
        url: {url0},{url1},{url2},{url3}, // ezopen播放地址逗号分隔
        autoplay: true,
        accessToken: "at.8o2k6dbpcvtr13reaa96hbnya6*************c",
        decoderPath: '{{location path}}',
        width: 1200, // 宽度高度为容器规格,将按照窗口数均分
        height: 800,
        splitBasis: 2 //设置窗口切割参数
      });


## 六、<a name="ezopen">播放地址获取及EZOPEN协议说明</a>

你可以通过开放平台官网获取各种格式视频直播地址,包含HLS格式,RTMP格式,WS格式,FLV格式等,EZUIKit支持所有格式直播视频播放。你可以将以上格式直播地址配置在UIKIT中直接播放,但需要注意,并非所有浏览器支持任意格式直播地址,为方便开发者使用,开放平台通过EZOPEN协议可以通过你终端类型帮助你轻松适配最优播放地址格式:
EZOPEN协议格式为 :

 【直播】 ezopen://open.ys7.com/[uuid][.hd].live   
 >*示例:ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.hd.live*
 
【预览】 ezopen://open.ys7.com/[uuid][.hd].live
      或ezopen://open.ys7.com/序列号/通道号[.hd].live
>*示例:ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.hd.live*
 
【回放】 ezopen://open.ys7.com/[uuid].rec?begin=yyyyMMddhhmmss&end=yyyyMMddhhmmss
       或ezopen://open.ys7.com/序列号/通道号.rec?begin=yyyyMMddhhmmss&end=yyyyMMddhhmmss
>*示例:ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.rec?begin=20180808000000&end=20180808235959*

>*简写模式:ezopen://open.ys7.com/f01018a141094b7fa138b9d0b856507b.rec?begin=20180808&end=20180808*

> *将播放2018年8月8日0点0分0秒至2018年8月8日23点59分59秒回放*

空文件

简介

Ezviz UI组件,可以快速实现视频应用 展开 收起
JavaScript
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
JavaScript
1
https://gitee.com/fyhLucky/EZUIKit-JavaScript.git
git@gitee.com:fyhLucky/EZUIKit-JavaScript.git
fyhLucky
EZUIKit-JavaScript
EZUIKit-JavaScript
master

搜索帮助

344bd9b3 5694891 D2dac590 5694891