[EZUIKit-JavaScript-npm][ezuikit-js]

轻应用npm版本，降低接入难度，适配自定义UI，适配主流框架

低延时预览，云存储回放，SD卡回放

功能API丰富，如：播放控制，音频控制，视频截图，实时获取视频OSDTime，视频录制，设备对讲，电子放大，全屏等

获取ezuikit-js

$ npm install ezuikit-js

引入ezuikit-js

import  EZUIKit from 'ezuikit-js';

如果你使用原生方法,可以通过标签引用

  <script src="./ezuikit.js"></script>

开始使用 - 初始化

基本使用

创建DOM

  <div id="video-container"></div>

播放器初始化

    var player = new EZUIKit.EZUIKitPlayer({
      id: 'video-container', // 视频容器ID
      accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
      url: 'ezopen://open.ys7.com/203751922/1.live',
    })

方法调用

示例： 停止播放

  1. player.stop();

  2. player.stop()
  .then(()=>{
    console.log("执行播放成功后其他动作");
  });

示例： 执行播放（自动播放为false,自定义触发播放/切换播放地址）

  player.play();
  // 切换播放地址场景（注意先执行stop方法停止上次取流）
  player.play({
   url: 'ezopen://open.ys7.com/203751922/1.rec?begin=202001000000&end=202001235959'
  });

切换地址播放（注意需要先执行stop方法停止上次取流）

  player.stop()
  .then(()=>{
    player.play('ezopen://open.ys7.com/{其他设备}/{其他通道}.live');
  });

  // 其他账号下设备
  
  player.stop()
  .then(()=>{
    player.play({url:'ezopen://open.ys7.com/{其他设备}/{其他通道}.live',accessToken: 'xxxx'});
  });
  

自定义主题切换播放地址

当template值为“theme”时，自定义主题地址切换需要同步主题中的按钮，回放控件等。

如果需要同步主题控件，需要调用以下方法切换播放地址

player.changePlayUrl(options)
  

options参数说明

|参数名|类型|描述|是否必选| |:--|:--|:--|:--| |type| String| 播放地址类型，"live":预览，"rec"：回放；“cloud.rec”：云存储回放| Y| |accessToken| String| 授权过程获取的access_token| Y| |deviceSerial | String | 设备序列号,存在英文字母的设备序列号，字母需为大写 | Y | |channelNo | int | 通道号 | Y | |hd | boolean | 是否为高清 true-主码流（高清） false-子码流(标清) | Y | |validCode |String| 设备验证码（加密设备播放需要输入验证码） |Y| |begin| String | type类型为回放有效，开始时间 格式为“YYYYMMDDHHmmss” |N| |end| String | type类型为回放有效，结束时间 格式为 “YYYYMMDDHHmmss” |N|

使用说明

初始化

|参数名|类型|描述|是否必选| |:--|:--|:--|:--| |id| String| 播放器容器DOM的id| Y| |accessToken| String| 授权过程获取的access_token| Y| |url |String| 视频ezopen协议播放地址 |Y| |audio| int | 是否默认开启声音 1：打开（默认） 0：关闭 |N| |autoplay| int | 是否自动播放 1：开启 0：关闭 |N| |width |int | 视频宽度，默认值为容器容器DOM宽度 |N| |height |int | 视频高度，默认值为容器容器DOM高度 |N| |template |string | 播放器模板，可以通过选定模板，使用内置的播放器样式，组件 simple：极简版;standard：标准版;security：安防版(预览回放);vioce：语音版;theme：自定义主题（v0.3.0版本及以上支持） |header |Array | simple：极简版 视频头部可选UI组件，可选值：capturePicture：截图,save：录像保存,zoom：电子放大 |N| |footer |Array | simple：极简版 视频底部部可选UI组件，可选值：talk：对讲,broadcast：语音播报,hd：高清标清切换,fullScreen：全屏 |N| |plugin |Array | 按需加载插件，可选值： talk：对讲 |N| |handleSuccess |function | 播放成功回调 |N| |handleError |function | 播放错误回调 |N| |openSoundCallBack |function | 开启声音回调 |N| |closeSoundCallBack |function | 关闭回调 |N| |startSaveCallBack |function | 开始录像回调 |N| |stopSaveCallBack |function | 结束录像回调 |N| |capturePictureCallBack |function | 截图回调 |N| |fullScreenCallBack |function | 全屏回调 |N| |fullScreenChangeCallBack |function | 全屏变化回调-全局（含ESC退出全屏等） |N| |getOSDTimeCallBack |function | 获取OSD时间回调 |N|

方法集合

|方法名|类型|描述|使用示例| |:--|:--|:--|:--| |stop| function| 结束播放| player.stop()| |openSound| String| 开启声音|player.openSound()| |closeSound |String|关闭声音 |player.closeSound()| |startSave| int |开始录像|player.startSave()| |stopSave|int |结束录像|player.stopSave()| |capturePicture| function| 视频截图| player.capturePicture()| |fullScreen| function| 全屏（自动适配移动端pc端全屏）| player.fullScreen()| |cancelFullScreen| function| 取消全屏| player.cancelFullScreen()| |getOSDTime| function| 获取播放时间回调| player.getOSDTime()| |startTalk| function| 开始对讲| player.startTalk()| |stopTalk| function| 结束对讲| player.stopTalk()|

使用示例

如果使用原生js，可参考demos => base-demo

如果使用react，可参考demos => react-demo

如果使用vue，可参考demos => vue-demo