feat: update 8.2.0

Author: freeshineit

README.md

@@ -273,11 +273,15 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 <tr><td>language</td><td>String</td><td>多语言 （zh | en）, 默认zh (v8.0.8版本及以上支持)</td><td>N</td></tr>
 <tr><td>debugDownloadData</td><td>boolean</td><td>下载原始码流， 调试码流使用, 默认 false (v8.1.1版本及以上支持)</td><td>N</td></tr>
 <tr><td>disableRenderPrivateData</td><td>boolean</td><td>禁止渲染私有数据(如智能分析， 移动侦测， 火点信息等), 默认 false (v8.1.1 - v.8.1.3 版本及以上支持)v.8.1.4 开始 默认 true</td><td>N</td></tr>
-<tr><td>quality</td><td>0 | 1 | 2 | 3 | 4 | 5 | 6 | pp | qp</td><td>预览初始化支持指定清晰度进行播放, 默认 undefined (v8.1.5版本及以上支持)， 0: 流畅； 1: 标清; 2: 高清; 3: 超清; 4: 极清; 5: 3K; 6: 4K ; "pp"： "性能优先 (Performance Priority)"; "qp": "画质优先(Quality Priority)"。 如果没有命中，默认取上次的设置</td><td>N</td></tr>
+<tr><td>quality</td><td>0 | 1 | 2 | 3 | 4 | 5 | 6 | pp | qp</td><td>预览初始化支持指定清晰度进行播放, 默认 undefined (v8.1.5版本及以上支持)， 0: 流畅； 1: 标清; 2: 高清; 3: 超清; 4: 极清; 5: 3K; 6: 4K ; "pp"： "性能优先 (Performance Priority)"; "qp": "画质优先(Quality Priority)"。 如果没有命中，默认取数组的第一个值</td><td>N</td></tr>
 <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><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版本及以上支持)</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>
 </table>
 
 ### 方法调用

demos/base-demo/index.html

@@ -75,7 +75,7 @@ <h2>视频模式使用示例：</h2>
             handleError: (error) => {
               console.error("handleError", error);
             },
-            scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏
+            scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
             env: {
               // https://open.ys7.com/help/1772?h=domain
               // domain默认是 https://open.ys7.com, 如果是私有化部署或海外的环境，请配置对应的domain
@@ -105,6 +105,10 @@ <h2>视频模式使用示例：</h2>
             //   { level: 0, name: "标清", streamTypeIn: 2 }, // 需要设备支持子码流
             //   { level: 1, name: "高清", streamTypeIn: 1 },
             // ],
+            // videoLevelList: [
+            //   { level: -1, name: "标清", streamTypeIn: 2 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+            //   { level: -2, name: "高清", streamTypeIn: 1 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+            // ]
           });
 
           // 8.1.x 版本, 9.x.x 移除了 eventEmitter

demos/base-demo/mobileLive.html

@@ -53,6 +53,7 @@ <h2>视频模式使用示例：</h2>
                 width: width,
                 height: (width * 9) / 16,
                 language: "en", // zh | en
+                scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
                 env: {
                     // https://open.ys7.com/help/1772?h=domain
                     // domain默认是 https://open.ys7.com, 如果是私有化部署或海外的环境，请配置对应的domain
@@ -76,6 +77,10 @@ <h2>视频模式使用示例：</h2>
                  */
                 streamInfoCBType: 1,
                 staticPath: "/ezuikit_static", // 如果想使用本地静态资源，请复制根目录下ezuikit_static 到当前目录下， 然后设置该值
+                // videoLevelList: [
+                //   { level: -1, name: "标清", streamTypeIn: 2 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+                //   { level: -2, name: "高清", streamTypeIn: 1 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+                // ]
             });
 
             // 8.1.x 版本, 9.x.x 移除了 eventEmitter

demos/base-demo/mobileRec.html

@@ -72,6 +72,7 @@
                     name: "ezuikit",
                     showTime: true,
                 },
+                scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
                 // 视频流的信息回调类型
                 /**
                  * 打开流信息回调，监听 streamInfoCB 事件
@@ -82,6 +83,10 @@
                  */
                 streamInfoCBType: 1,
                 staticPath: "/ezuikit_static", // 如果想使用本地静态资源，请复制根目录下ezuikit_static 到当前目录下， 然后设置该值
+                // videoLevelList: [
+                //   { level: -1, name: "标清", streamTypeIn: 2 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+                //   { level: -2, name: "高清", streamTypeIn: 1 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+                // ]
             });
 
             // 8.1.x 版本, 9.x.x 移除了 eventEmitter

demos/base-demo/multi.html

@@ -106,6 +106,7 @@
               console.error("handleError", error);
             },
             download: false,
+            scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
             env: {
               // https://open.ys7.com/help/1772?h=domain
               // domain默认是 https://open.ys7.com, 如果是私有化部署或海外的环境，请配置对应的domain

demos/base-demo/pcLive.html

@@ -42,6 +42,7 @@ <h2>视频模式使用示例：</h2>
           template: 'pcLive', //  simple: 极简版; pcLive: 预览; pcRec: 回放; security: 安防版; voice: 语音版; 
           // width: 600,
           // height: 400,
+          scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
           env: {
             // https://open.ys7.com/help/1772?h=domain
             // domain默认是 https://open.ys7.com, 如果是私有化部署或海外的环境，请配置对应的domain

demos/base-demo/template.html

@@ -72,6 +72,7 @@ <h2>视频模式使用示例：</h2>
         // width: 600,
         height: 400,
         staticPath: staticPath, // 如果想使用本地静态资源，请复制根目录下ezuikit_static 到当前目录下， 然后设置该值
+        scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
         env: {
           // https://open.ys7.com/help/1772?h=domain
           // domain默认是 https://open.ys7.com, 如果是私有化部署或海外的环境，请配置对应的domain

demos/base-demo/themeDataLive.html

@@ -166,6 +166,7 @@ <h4>themeData.footer</h4>
       player = new EZUIKit.EZUIKitPlayer({
         id: 'video-container', // 视频容器ID
         autoplay: false,
+        scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
         ...opt,
         env: {
           // https://open.ys7.com/help/1772?h=domain

demos/base-demo/themeDataRec.html

@@ -170,6 +170,7 @@ <h4>themeData.footer</h4>
 
       player = new EZUIKit.EZUIKitPlayer({
         id: 'video-container', // 视频容器ID
+        scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
         ...opt,
         env: {
           // https://open.ys7.com/help/1772?h=domain

demos/react-demo/src/Player.js

@@ -33,7 +33,8 @@ const Player = () => {
         template: "pcLive",
         language: "zh", // zh | en
         // quality: 1, // 
-        // isCloudRecord: true, // 如果是云录制的播放 需要这个值，是必须的. 8.2.0 开始默认支持云录制，不需要此参数
+        // isCloudRecord: true, // 如果是云录制的播放需要这个值(8.1.x)是必须的. 8.2.0 开始默认支持云录制，不需要此参数
+        scaleMode: 1, // 默认 0 完全填充窗口，会有拉伸 1: 等比适配 2: 等比完全填充窗口, 超出隐藏 @sine 8.2.0
         env: {
           // https://open.ys7.com/help/1772?h=domain
           // domain默认是 https://open.ys7.com, 如果是私有化部署或海外的环境，请配置对应的domain
@@ -63,6 +64,10 @@ const Player = () => {
         //   { level: 1, name: "标清", streamTypeIn: 2 }, // 需要保证支持子码流 (streamTypeIn=2)
         //   { level: 2, name: "高清", streamTypeIn: 1 },
         // ],
+        // videoLevelList: [
+        //   { level: -1, name: "标清", streamTypeIn: 2 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+        //   { level: -2, name: "高清", streamTypeIn: 1 }, // 8.1.17 开始 当 level 的值小于 0时， 不在向设备发送指令，仅根据 streamTypeIn 切换码流 （请保证 streamTypeIn 对应的码流存在）
+        // ]
       });
 
       window.player = player.current;