ezuikit-js 8.2.0-beta.8 → 8.2.1-beta.1

package/CHANGELOG.md

@@ -1,4 +1,4 @@
-### v8.2.0 (2025-10-15)
+### v8.2.0 (2025-11-24)
 
 #### Feat
 

package/README.md

@@ -80,6 +80,7 @@ const player = new EZUIKitPlayer({
   url: "ezopen://open.ys7.com/BC7900686/1.live",
   width: 600,
   height: 400,
+  scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
   handleError: (err) => {
     if (err.type === "handleRunTimeInfoError" && err.data.nErrorCode === 5) {
       // 加密设备密码错误
@@ -96,6 +97,7 @@ const player = new EZUIKitPlayer({
   id: "video-container", // 视频容器ID
   width: 600,
   height: 400,
+  scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
   accessToken:
     "at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz",
   url: "ezopen://open.ys7.com/BC7900686/1.rec",
@@ -127,8 +129,10 @@ alpha（功能测试）、beta（集成测试）为我们的非正式版本，
 > 如果使用 vue2.6，可参考 demos => [with-vue2.6](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-vue2.6)
 >
 > 如果使用 uniapp + vue3 ，可参考 demos => [with-uniapp-vue3](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-uniapp-vue3)
->
+
 > 如果使用 uniapp + vue2 ，可参考 demos => [with-uniapp-vue2](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-uniapp-vue2)
+ 
+> 如果使用 docker + nginx ，可参考 demos => [with-docker-nginx](https://github.com/Ezviz-OpenBiz/EZUIKit-JavaScript-npm/tree/master/demos/with-docker-nginx)
 
 #### tips
 
@@ -277,11 +281,15 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 <tr><td>loggerOptions</td><td> {name: string, level: "INFO" | "LOG" | "WARN" | "ERROR" , showTime: boolean}</td><td>本地日志设置， 默认值 {name: "ezuikit", level: "INFO", showTime: true}, 支持动态设置请参考 <a href="#日志设置">setLoggerOptions(options)</a> (v8.1.9版本及以上支持)</td><td>N</td></tr>
 <tr><td>streamInfoCBType</td><td>  0 | 1 </td><td>  流信息回调类型，监听 streamInfoCB 事件, 0 : 每次都回调（会影响性能）, 1 : 只回调一次, 默认值 1 (v8.1.9版本及以上支持)</td><td>N</td></tr>
 
+<tr><td>isCloudRecord</td><td> boolean </td><td>适用 8.1.x 云录制，8.2.x 已移除并默认支持云录制</td><td>N</td></tr>
+
 <tr><td><a href="./videoLevelList.md" target="_blank">videoLevelList</a></td><td> <span>Array<{ </br>/** 清晰度 */</br>level: number, </br>/** 名称 */ </br>name: string, </br> /**1: 主码流,2: 子码流*/</br>streamTypeIn: 1 | 2 }> <span>| null </td><td>  自定义清晰度列表，默认null, 如果有值 sdk 内部不在进行获取, 为 null 使用接口获取的清晰度列表, videoLevelList.length === 0 不展示清晰度控件 sdk 内部不在进行获取, videoLevelList.length > 0 展示控件 sdk 内部不在进行获取 (v8.1.10版本及以上支持);
 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
 </td><td>N</td></tr>
 
 <tr><td>scaleMode</td><td> 0 | 1 | 2</td><td> 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0 </td><td>N</td></tr>
+
+<tr><td><a href="./cloudRecord.md">spaceId</a></td><td> number</td><td> 云录制空间 ID (仅云录制生效) @sine 8.2.0 </td><td>N</td></tr>
 </table>
 
 ### 方法调用
@@ -423,13 +431,15 @@ player.eventEmitter.on("volumeChange", ({ data }) => {
 #### 全屏
 
 ```js
-player.fullScreen();
+player.fullScreen(); // 8.2.0 开始移除 
+player.fullscreen(); // 8.2.0 新增
 ```
 
 #### 取消全屏
 
 ```js
-player.cancelFullScreen();
+player.cancelFullScreen(); // 8.2.0 开始移除 
+player.exitFullscreen(); // 8.2.0 新增
 ```
 
 #### 获取 OSD 时间
@@ -468,12 +478,15 @@ options 参数说明
 > 可用于在播放中切换模板主题，请切换播放地址成功后调用
 
 ```js
-player.Theme.changeTheme(template);
+player.Theme.changeTheme(template); // 8.2.0 开始移除 
+
+player.changeTheme(template); // 8.2.0 新增
 
 // 预览切回放场景示例
 player.changePlayUrl({ type: "rec" }).then(() => {
   console.log("地址切换成功，开始切换模板主题");
-  player.Theme.changeTheme("pcRec");
+  // player.Theme.changeTheme("pcRec"); // 8.2.0 开始移除
+  player.changeTheme("pcRec"); // 8.2.0 新增
 });
 ```
 
@@ -510,7 +523,7 @@ player.closeZoom().then(() => {
 #### 重置画面宽高
 
 ```js
-player.resize(width, height);
+player.resize(width, height); // 8.2.0 开始支持宽高参数为字符串（如 100% , 100vw , 100vh 10em, 10rem 等）
 ```
 
 #### 鱼眼矫正（软解 开启 [SharedArrayBuffer](https://open.ys7.com/help/1772?h=SharedArrayBuffer)）
@@ -725,17 +738,35 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.exitFullscreen, () => {
 全屏变化事件 `EZUIKitPlayer.EVENTS.fullscreenChange`
 
 ```js
+// 8.2.0 移除
 // interface FullscreenChangeData {
 //   "isCurrentFullscreen": boolean, // 全局全屏
 //   "isCurrentBrowserFullscreen":boolean // 全局全屏和web 全屏
 // }
 // 监听全屏变化事件
-player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreenChange, (data) => {
+player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreenChange, (info) => {
   // {data: FullscreenChangeData}
-  console.log("fullscreenChange", data);
+  console.log("fullscreenChange", info);
 });
 ```
 
+```js
+// 8.2.0 新增
+// interface FullscreenChangeData {
+//    "isCurrentFullscreen":true, // 当前窗口是否全屏
+//    "isFullscreen":true, // 页面是否有全屏
+//    "isMobile":false,  // 是否是移动端
+//    "orientationAngle":0 // 屏幕旋转角度（适用移动端和pad ）
+// }
+// 监听全屏变化事件
+player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreenChange, (info) => {
+  // {data: FullscreenChangeData}
+  console.log("fullscreenChange", info);
+});
+```
+
+
+
 #### 首帧渲染事件
 
 首帧渲染事件 `EZUIKitPlayer.EVENTS.firstFrameDisplay`
@@ -764,8 +795,9 @@ resize 事件事件 `EZUIKitPlayer.EVENTS.resize`
 
 ```js
 // 监听resize事件
-player.eventEmitter.on(EZUIKitPlayer.EVENTS.resize, () => {
-  // {data: {"width": number,"height":number}}
+player.eventEmitter.on(EZUIKitPlayer.EVENTS.resize, (data) => {
+  // {data: {"width": number,"height":number}} // 8.2.0 开始移除
+  // {"width":number,"height":number,"isCurrentFullscreen":true,"orientationAngle":0} // 8.2.0 开始添加
   console.log("resize", data);
 });
 ```
@@ -858,6 +890,8 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.reSetTheme, () => {
 });
 ```
 
+8.2.0 开始不在支持
+
 #### 回放时间变化事件
 
 回放时间变化事件 `EZUIKitPlayer.EVENTS.recTimeChange`
@@ -944,7 +978,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.fast, ({ data }) => {
 });
 ```
 
-倍速下降事件 `EZUIKitPlayer.EVENTS.fast`
+倍速下降事件 `EZUIKitPlayer.EVENTS.slow`
 
 ```js
 // 监听倍速下降事件