ezuikit-js 7.7.9-beta1 → 7.7.10-alpha.2

package/CHANGELOG.md

@@ -1,18 +1,22 @@
-v 7.7.9
-Date: 2023-12-13
-[add] 支持设置画面水印
+## v7.7.10
 
-v 7.7.8
-Date: 2023-11-20
-[add] 新增对讲模式切换判断
-[add] 初始化支持配置设备当前时区
-[fix] 去除埋点数据上报敏感信息
+[feat] 新增云录制回放支持 （暂时仅对内使用）
 
-v 7.7.7
-Date: 2023-11-20
-[feat] 单线程、高性能版本解码库合并，根据当前环境自动选择最优解码库
+## v7.7.2 (2023-08-11)
 
-v 0.6.5
+[feat] 支持软解鱼眼矫正， 支持四分屏
+
+[feat] 加密设备，秘钥错误添加错误回调
+
+## v7.7.1 (2023-08-09)
+
+[fix] 修复多屏回放日期选择器渲染问题
+
+## v6.7.8 (2023-07-20)
+
+[feat] `EZUIKit.FLV()` 支持硬解播放H265
+
+# v0.6.5
 
 [feat] 播放暂停时播放窗口保留最后一帧画面
 
@@ -20,48 +24,96 @@ v 0.6.5
 
 [fix] 开启录制时切换地址则录制自动完成
 
-v 0.6.4
+## v0.6.4  
+
+[fix]修复地址切换频繁多路流导致画面跳变问题 
+
+[fix]优化多线程版本单个页面创建多路视频播放性能及稳定性  
+
+[fix]修复多线程内存泄露问题  
+
+[fix]修复模板主题回放拖动声音被关闭，设备名称展示不全，全屏高度计算异常问题。  
+
+## v0.6.3  
+
+[feat]支持模板内回放时间轴自定义设置拖动防抖间隔  
+
+[feat]支持模板内网页全屏状态下调用日历切换日期  
+
+[fix]修复单线程模式下，设备断网视频未保留最后一帧问题  
+
+[fix]修复模板内使用电子放大开启中切换设备未重置问题  
+
+
+## v0.6.2  
+
+[feat] 支持用户通过开启谷歌实验室特性启动多线程解码  
+
+[feat] 支持用户在开放平台控制台（https://open.ys7.com/console/ezuikit/template.html）创建，修改，删除，查询多个模板  
+
+[feat] 优化模板内高清/标清切换缓慢问题。  
+
+[feat] 支持切换主题  
+
+[feat] 支持根据主题ID自定义主题  
+
+[feat] 新增pc端电子放大，移动端双指缩放功能  
+
+[feat] 新增倍速回放功能  
+
+
+## v0.6.1  
+
+[feat] 支持本地配置解码库，解决远程拉取缓慢问题。  
+
+## v0.6.0  
+
+[fix]兼容低版本火狐浏览器播放视频   
+
+[fix]修复网站全屏模式下，再次执行视频全屏冲突问题  
 
-[fix]修复地址切换频繁多路流导致画面跳变问题
 
-[fix]优化多线程版本单个页面创建多路视频播放性能及稳定性
+## v0.5.9  
 
-[fix]修复多线程内存泄露问题
+[feat]支持用户通过开启谷歌实验室特性启动多线程解码   
 
-[fix]修复模板主题回放拖动声音被关闭，设备名称展示不全，全屏高度计算异常问题。
+[feat]新增开启开启谷歌实验室特性引导说明  
 
-v 0.6.3
+## v0.5.8  
+[feat-beta]支持多线程解码视频-beta
 
-[feta]支持模板内回放时间轴自定义设置拖动防抖间隔
+## v0.5.7  
+[feat]新增对讲成功回调，用于国标对讲成功，开启视频声音  
 
-[feta]支持模板内网页全屏状态下调用日历切换日期
+[feat]新增对讲失败回调，返回对讲失败错误信息  
 
-[fix]修复单线程模式下，设备断网视频未保留最后一帧问题
+[fix]修复无子账号对讲权限不足，错误未捕获问题  
 
-[fix]修复模板内使用电子放大开启中切换设备未重置问题
+## v0.5.5  
+[fix]修复无子账号对讲权限不足，错误未捕获问题  
 
-v 0.6.2
+[feat]增加设备能力探测，对讲前检测设备能力  
 
-[feta] 支持用户通过开启谷歌实验室特性启动多线程解码
+[feat]增加loading状态文案字体大小样式  
 
-[feta] 支持用户在开放平台控制台（https://open.ys7.com/console/ezuikit/template.html）创建，修改，删除，查询多个模板
+[fix]修复乾坤框架下，全局对象获取不到导致对讲失败问题  
 
-[feta] 优化模板内高清/标清切换缓慢问题。
 
-[feta] 支持切换主题
+## v0.5.4  
+[fix]修复视频宽度小于500，按钮过大问题
 
-[feta] 支持根据主题ID自定义主题
+## v0.5.3  
 
-[feta] 新增pc端电子放大，移动端双指缩放功能
+[feat]兼容部分浏览器formData格式  
 
-[feta] 新增倍速回放功能
+[feat]结束对讲释放麦克风  
 
-v 0.6.1
+## v0.5.1  
 
-[feta] 支持本地配置解码库，解决远程拉取缓慢问题。
+Date: 2022年3月31日 19:39:49  
 
-v 0.6.0
+[feat]支持切换主题  
 
-[fix]兼容低版本火狐浏览器播放视频
+[fix]修复对讲结束问题问题  
 
-[fix]修复网站全屏模式下，再次执行视频全屏冲突问题
+[feat]移动端主题支持隐藏回放时间轴  

package/README.md

@@ -1,5 +1,11 @@
 #  [EZUIKit-JavaScript-npm][ezuikit-js]
->轻应用npm版本，降低接入难度，适配自定义UI，适配主流框架
+
+![Download](https://img.shields.io/npm/dm/ezuikit-js.svg)
+![Version](https://img.shields.io/npm/v/ezuikit-js.svg)
+![License](https://img.shields.io/npm/l/ezuikit-js.svg)
+
+
+> 轻应用npm版本，降低接入难度，适配自定义UI，适配主流框架
 
 > 低延时预览，云存储回放，SD卡回放
 
@@ -10,7 +16,15 @@
 ### 获取ezuikit-js
 
 ```
-$ npm install ezuikit-js
+npm install ezuikit-js
+
+# yarn
+
+yarn add ezuikit-js
+
+# pnpm
+
+pnpm add ezuikit-js
 ```
 ### 引入ezuikit-js
 
@@ -19,12 +33,15 @@ import EZUIKit from 'ezuikit-js';
 ```
 
 #### 如果你使用原生方法,可以通过标签引用
+
 ```
+  <!-- umd -->
   <script src="./ezuikit.js"></script>
 ```
 
 ### 开始使用 - 初始化
->基本使用
+
+> 基本使用
 
 创建DOM
 
@@ -33,32 +50,42 @@ import EZUIKit from 'ezuikit-js';
 ```
 
 ## 播放器初始化
+
 ### 直播
-```
+
+```js
     var player = new EZUIKit.EZUIKitPlayer({
       id: 'video-container', // 视频容器ID
       accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
-      url: 'ezopen://open.ys7.com/AA2615287/1.live',
+      url: 'ezopen://open.ys7.com/G39444019/1.live',
       width: 600,
       height: 400,
+      handleError: (err) => {
+        if (err.type === "handleRunTimeInfoError" && err.data.nErrorCode === 5) {
+          // 加密设备密码错误
+        }
+      },
     })
 ```
+
 ### 回放
-```
+
+```js
     var player = new EZUIKit.EZUIKitPlayer({
       id: 'video-container', // 视频容器ID
       width: 600,
       height: 400,
       accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
-      url: 'ezopen://open.ys7.com/AA2615287/1.rec'
+      url: 'ezopen://open.ys7.com/G39444019/1.rec'
     })
 ```
 #### tips
+
 为方便开发者快速接入  
 
 我们提供了测试accessToken,测试播放地址，并提供了几种常用场景使用示例。你可以通过使用示例，使用测试播放地址，测试accessToken，在你的应用快速接入。  
 
-<b>测试播放地址：</b> ezopen://open.ys7.com/AA2615287/1.live  
+<b>测试播放地址：</b> ezopen://open.ys7.com/G39444019/1.live  
 
 你可以通过以下地址获取到测试accessToken <a href="https://open.ys7.com/jssdk/ezopen/demo/token" target="_blank">获取测试accessToken</a> 用来播放上述测试播放地址。 
 
@@ -66,13 +93,13 @@ import EZUIKit from 'ezuikit-js';
 
 1. 我们在v0.6.2及以上版本持用户通过开启谷歌实验室特性启动多线程解码，多线程模式将大大提升解码效率，降低解码内存消耗。  
 
->>[开启多线程方式1](https://open.ys7.com/help/384)  (https://open.ys7.com/help/384)
+> [开启多线程方式1](https://open.ys7.com/help/384)(https://open.ys7.com/help/384)
 
->>[开启多线程方式2](https://open.ys7.com/help/385)(https://open.ys7.com/help/385)  
+> [开启多线程方式2](https://open.ys7.com/help/385)(https://open.ys7.com/help/385)  
 
 2. 视频解码库默认从开放平台远程拉取，你可以将解码库放到本地或者你的服务内，可以提升加载解码库速度。 
 
- >> <b>使用本地解码库提升加载速度</b>  <a href="https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/blob/master/demos/base-demo/localDecoder.html" target="_blank">本地解码库示例</a> 
+ > <b>使用本地解码库提升加载速度</b>  <a href="https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/blob/master/demos/base-demo/localDecoder.html" target="_blank">本地解码库示例</a> 
 
 ### 使用示例
 > 1. 快速创建视频播放页面  
@@ -128,7 +155,7 @@ ezopen://open.ys7.com/${设备序列号}/{通道号}.rec?begin=yyyyMMddhhmmss
 ##### 云存储回放
 初始化参数 url值为：<br/>
 ezopen://open.ys7.com/${设备序列号}/{通道号}.cloud.rec?begin=yyyyMMddhhmmss
-视频ezopen协议播放地址 详见：<a href="http://open.ys7.com/doc/zh/readme/ezopen.html" target="_blank">ezopen协议</a>	</td><td>Y</td></tr>
+视频ezopen协议播放地址 详见：<a href="https://open.ys7.com/help/23" target="_blank">ezopen协议</a>	</td><td>Y</td></tr>
 <tr><td>audio</td><td>boolean</td><td>是否默认开启声音 true：打开（默认） false：关闭	</td><td>N</td></tr>
 <tr><td>width</td><td>int</td><td>视频宽度，默认值为容器容器DOM宽度	</td><td>Y</td></tr>
 <tr><td>height</td><td>int</td><td>视频高度，默认值为容器容器DOM高度</td><td>Y</td></tr>
@@ -281,16 +308,19 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 </td><td>N</td></tr>
 <tr><td>plugin</td><td>String</td><td>按需加载插件，可选值： talk：对讲，示例：plugin:["talk"] </td><td>N</td></tr>
 <tr><td>handleSuccess</td><td>function</td><td>自动播放成功回调</td><td>N</td></tr>
+<tr><td>handleError</td><td>function</td><td>错误回调</td><td>N</td></tr>
 <tr><td>seekFrequency </td><td>function</td><td>为避免频繁拖动播放异常，可设置模板回放时间轴拖动防抖间隔，默认值为2000（2秒），可取2000（2秒），3000（3秒），4000（4秒），5000（5秒）</td><td>N</td></tr>
 </table>
 
 
 ### 方法调用
+
 > 同步方法（方式1）
 > 方法支持通过promise回调，可通过回调方式执行下一步动作（方式2）。
 
 #### 开始播放
-```
+
+```js
   // 方式1
   player.play();
   // 方式2
@@ -299,9 +329,10 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
     console.log("执行播放成功后其他动作");
   });
 ```
+
 #### 停止播放
 
-```
+```js
   // 方式1
   player.stop();
   // 方式2
@@ -310,9 +341,10 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
     console.log("执行停止成功后其他动作");
   });
 ```
+
 #### 开启声音
 
-```
+```js
   // 方式1
   player.openSound();
   // 方式2
@@ -321,10 +353,12 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
     console.log("执行开启声音成功后其他动作");
   });
 ```
+
 #### 开始录制
 > 因录制解码库加载限制，录制库加载需要3S秒左右，请保证录制时长需要大于5秒。
 > 录制文件需要使用播放器，播放器下载地址 <a href="https://service.ys7.com/downloadInfoSite/admin">播放器下载</a>
-```
+
+```js
   // 方式1
   player.startSave("唯一文件名");
   // 方式2
@@ -335,7 +369,7 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 ```
 #### 停止录制并下载文件
 
-```
+```js
   // 方式1
   player.stopSave();
   // 方式2
@@ -344,9 +378,10 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
     console.log("执行停止录制成功后其他动作");
   });
 ```
+
 #### 抓图
 
-```
+```js
   // 方式1 - 下载到本地
   player.capturePicture("文件名");
   // 方式2 - 返回base64格式
@@ -357,29 +392,31 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 ```
 #### 开始对讲
 
-```
+```js
   player.startTalk();
 ```
 
 #### 结束对讲
 
-```
+```js
   player.stopTalk();
 ```
 
 #### 全屏
 
-```
+```js
   player.fullScreen();
 ```
+
 #### 取消全屏
 
-```
+```js
   player.cancelFullScreen();
 ```
+
 #### 获取OSD时间
 
-```
+```js
    player.getOSDTime()
   .then((time)=>{
     console.log("获取到的当前播放时间", time);
@@ -390,7 +427,7 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 
 > 可用于在播放中切换设备，切换播放参数，以及直播切换回放等。请注意，频繁切换可能导致异常，切换间隔至少需要1秒
 
-```
+```js
   player.changePlayUrl(options)
   .then(()=>{
     console.log("切换成功")
@@ -413,10 +450,11 @@ options参数说明
 
   
 
-#### 切换模板主题  
+#### 切换模板主题 
+
 > 可用于在播放中切换模板主题，请切换播放地址成功后调用
 
-```
+```js
   player.Theme.changeTheme(template)
 
   // 预览切回放场景示例
@@ -428,6 +466,7 @@ options参数说明
   
 
 ```
+
 template参数说明
 
 |参数名|类型|描述|是否必选|
@@ -436,9 +475,10 @@ template参数说明
 
 
 #### 开启电子放大
+
 >建议使用模板，模板中的电子放大功能更全
 
-```
+```js
   // 方式1
   player.enableZoom();
   // 方式2
@@ -447,9 +487,10 @@ template参数说明
     console.log("开启电子放大成功");
   });
 ```
+
 #### 关闭电子放大
 
-```
+```js
   // 方式1
   player.closeZoom();
   // 方式2
@@ -461,14 +502,31 @@ template参数说明
 
 #### 重置画面宽高
 
-```
+```js
   player.reSize(width, height);
 ```
 
+#### 鱼眼矫正（软解）
+
+```js
+// {1, 0}  壁装鱼眼 不矫正
+// {1, 1}  壁装360°全景
+// {1, 2}  壁装4分屏
+// {1, 4}  壁装广角
+// {3, 0}  顶装鱼眼 不矫正
+// {3, 1}  顶装360°全景
+// {3, 4}  顶装4分屏
+// {3, 5}  顶装柱状
+// 顶装4分屏
+player.setFECCorrectType({place: 3 , type：4}, "cavnas1,canvas2,canvas3") // cavnas1,canvas2,canvas3 是分屏是需要的
+```
+
 ### 使用示例
 
-> 如果使用原生js，可参考demos => base-demo
+> 如果使用原生js，可参考demos => [base-demo](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/base-demo)
+
+> 如果使用react，可参考demos => [react-demo](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/react-demo)
 
-> 如果使用react，可参考demos => react-demo
+> 如果使用vue2，可参考demos => [vue-demo](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/vue-demo)
 
-> 如果使用vue，可参考demos => vue-demo
+> 如果使用vue3，可参考demos => [vue3-demo](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/vue3-demo)