docs: update

Author: freeshineit

README.md

@@ -30,7 +30,7 @@ pnpm add ezuikit-js
 ### 引入 ezuikit-js
 
 ```js
-import EZUIKit from 'ezuikit-js';
+import EZUIKit from "ezuikit-js";
 ```
 
 #### 如果你使用原生方法,可以通过标签引用
@@ -56,13 +56,14 @@ import EZUIKit from 'ezuikit-js';
 
 ```js
 const player = new EZUIKit.EZUIKitPlayer({
-  id: 'video-container', // 视频容器ID
-  accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
-  url: 'ezopen://open.ys7.com/BD3957004/1.live',
+  id: "video-container", // 视频容器ID
+  accessToken:
+    "at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz",
+  url: "ezopen://open.ys7.com/BD3957004/1.live",
   width: 600,
   height: 400,
   handleError: (err) => {
-    if (err.type === 'handleRunTimeInfoError' && err.data.nErrorCode === 5) {
+    if (err.type === "handleRunTimeInfoError" && err.data.nErrorCode === 5) {
       // 加密设备密码错误
     }
   },
@@ -73,11 +74,12 @@ const player = new EZUIKit.EZUIKitPlayer({
 
 ```js
 const player = new EZUIKit.EZUIKitPlayer({
-  id: 'video-container', // 视频容器ID
+  id: "video-container", // 视频容器ID
   width: 600,
   height: 400,
-  accessToken: 'at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz',
-  url: 'ezopen://open.ys7.com/BD3957004/1.rec',
+  accessToken:
+    "at.3bvmj4ycamlgdwgw1ig1jruma0wpohl6-48zifyb39c-13t5am6-yukyi86mz",
+  url: "ezopen://open.ys7.com/BD3957004/1.rec",
 });
 ```
 
@@ -115,14 +117,14 @@ alpha（功能测试）、beta（集成测试）为我们的非正式版本，
 
 ```js
 const player = new EZUIKit.EZUIKitPlayer({
-  id: 'playWind',
+  id: "playWind",
   width: 600,
   height: 400,
-  template: 'pcLive',
-  url: '',
-  accessToken: '',
+  template: "pcLive",
+  url: "",
+  accessToken: "",
   env: {
-    domain: 'https://iusopen.ezvizlife.com', // 北美地区
+    domain: "https://iusopen.ezvizlife.com", // 北美地区
   },
 });
 ```
@@ -203,7 +205,7 @@ ezopen://open.ys7.com/${设备序列号}/{通道号}.hd.live<br/>
 
 ##### 云存储回放
 
-初始化参数 url 值为：<br/> ezopen://open.ys7.com/${设备序列号}/{通道号}.cloud.rec?begin=yyyyMMddhhmmss视频 ezopen 协议播放地址 详见：<a href="https://open.ys7.com/help/23" target="_blank">ezopen 协议</a> </td><td>Y</td></tr>
+初始化参数 url 值为：<br/> ezopen://open.ys7.com/${设备序列号}/{通道号}.cloud.rec?begin=yyyyMMddhhmmss 视频 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>
@@ -378,7 +380,7 @@ themeData将主题数据本地化，设置本地数据，需要删除template参
 player.play();
 // 方式2
 player.play().then(() => {
-  console.log('执行播放成功后其他动作');
+  console.log("执行播放成功后其他动作");
 });
 ```
 
@@ -389,7 +391,7 @@ player.play().then(() => {
 player.stop();
 // 方式2
 player.stop().then(() => {
-  console.log('执行停止成功后其他动作');
+  console.log("执行停止成功后其他动作");
 });
 ```
 
@@ -400,7 +402,7 @@ player.stop().then(() => {
 player.openSound();
 // 方式2
 player.openSound().then(() => {
-  console.log('执行开启声音成功后其他动作');
+  console.log("执行开启声音成功后其他动作");
 });
 ```
 
@@ -417,10 +419,10 @@ player.closeSound();
 
 ```js
 // 方式1
-player.startSave('唯一文件名');
+player.startSave("唯一文件名");
 // 方式2
-player.startSave('唯一文件名').then(() => {
-  console.log('执行开始录制成功后其他动作');
+player.startSave("唯一文件名").then(() => {
+  console.log("执行开始录制成功后其他动作");
 });
 ```
 
@@ -431,20 +433,20 @@ player.startSave('唯一文件名').then(() => {
 player.stopSave();
 // 方式2
 player.stopSave().then(() => {
-  console.log('执行停止录制成功后其他动作');
+  console.log("执行停止录制成功后其他动作");
 });
 ```
 
 #### 抓图
 
 ```js
 // 方式1 - 下载到本地
-player.capturePicture('文件名');
+player.capturePicture("文件名");
 // 方式2 - 返回base64格式
 const capCallback = (data) => {
-  console.log('data', data);
+  console.log("data", data);
 };
-player.capturePicture('default', capCallback);
+player.capturePicture("default", capCallback);
 ```
 
 #### 开始对讲
@@ -497,7 +499,7 @@ player.setProfile({ microphoneId });
 #### 监听麦克风音量变化
 
 ```js
-player.eventEmitter.on('volumeChange', ({ data }) => {
+player.eventEmitter.on("volumeChange", ({ data }) => {
   // 动态显示音柱,100ms触发一次
   console.log(`${data * 100}%`);
 });
@@ -519,7 +521,7 @@ player.cancelFullScreen();
 
 ```js
 player.getOSDTime().then((time) => {
-  console.log('获取到的当前播放时间', time);
+  console.log("获取到的当前播放时间", time);
 });
 ```
 
@@ -529,7 +531,7 @@ player.getOSDTime().then((time) => {
 
 ```js
 player.changePlayUrl(options).then(() => {
-  console.log('切换成功');
+  console.log("切换成功");
 });
 ```
 
@@ -554,9 +556,9 @@ options 参数说明
 player.Theme.changeTheme(template);
 
 // 预览切回放场景示例
-player.changePlayUrl({ type: 'rec' }).then(() => {
-  console.log('地址切换成功，开始切换模板主题');
-  player.Theme.changeTheme('pcRec');
+player.changePlayUrl({ type: "rec" }).then(() => {
+  console.log("地址切换成功，开始切换模板主题");
+  player.Theme.changeTheme("pcRec");
 });
 ```
 
@@ -575,7 +577,7 @@ template 参数说明
 player.enableZoom();
 // 方式2
 player.enableZoom().then(() => {
-  console.log('开启电子放大成功');
+  console.log("开启电子放大成功");
 });
 ```
 
@@ -586,7 +588,7 @@ player.enableZoom().then(() => {
 player.closeZoom();
 // 方式2
 player.closeZoom().then(() => {
-  console.log('关闭电子放大成功');
+  console.log("关闭电子放大成功");
 });
 ```
 
@@ -632,7 +634,7 @@ options 参数说明
 
 ## 事件
 
-所有事件名 `EZUIKitPlayer.EVENTS`, 事件监听player.eventEmitter.on() 和事件取消 player.eventEmitter.off()
+所有事件名 `EZUIKitPlayer.EVENTS`, 事件监听 player.eventEmitter.on() 和事件取消 player.eventEmitter.off()
 
 #### 流信息事件
 
@@ -642,7 +644,7 @@ options 参数说明
 // 监听流信息事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.streamInfoCB, (info) => {
   // 包括 视频信息 音频信息
-  console.log('streamInfoCB', info);
+  console.log("streamInfoCB", info);
 });
 ```
 
@@ -661,7 +663,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.streamInfoCB, (info) => {
 // 监听音频信息变化
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.audioInfo, (info) => {
   // {"audioFormat":8193,"audioFormatName":"AAC","audioChannels":1,"audioBitsPerSample":16,"audioSamplesRate":16000,"audioBitRate":32000}
-  console.log('audioInfo', info);
+  console.log("audioInfo", info);
 });
 ```
 
@@ -682,7 +684,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.audioInfo, (info) => {
 // 监听视频信息变化
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.videoInfo, (info) => {
   // {"videoFormat":5,"videoFormatName":"H265","width":3840,"height":2160,"frameRate":15,"intervalOfIFrame":0}
-  console.log('videoInfo', info);
+  console.log("videoInfo", info);
 });
 ```
 
@@ -701,7 +703,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.videoInfo, (info) => {
 // 监听截图事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.capturePicture, (info) => {
   // {data: CapturePictureInfoDate}
-  console.log('capturePictureInfo', info);
+  console.log("capturePictureInfo", info);
 });
 ```
 
@@ -718,7 +720,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.capturePicture, (info) => {
 // 监听截图事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.capturePicture, (info) => {
   // {data: CapturePictureInfoData}
-  console.log('capturePictureInfo', info);
+  console.log("capturePictureInfo", info);
 });
 ```
 
@@ -735,7 +737,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.capturePicture, (info) => {
 // 监听截图事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.changeVideoLevel, (info) => {
   // {data: VideoLevelData}
-  console.log('changeVideoLevel', info);
+  console.log("changeVideoLevel", info);
 });
 ```
 
@@ -785,7 +787,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.destroy, () => {
 });
 ```
 
-### 全屏相关事件
+#### 全屏相关事件
 
 全屏事件 `EZUIKitPlayer.EVENTS.fullscreen`
 
@@ -815,7 +817,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.exitFullscreen, () => {
 // 监听全屏变化事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.fullscreenChange, (data) => {
   // {data: FullscreenChangeData}
-  console.log('fullscreenChange', data);
+  console.log("fullscreenChange", data);
 });
 ```
 
@@ -841,15 +843,15 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.init, () => {
 });
 ```
 
-#### resize事件
+#### resize 事件
 
-resize事件事件 `EZUIKitPlayer.EVENTS.resize`
+resize 事件事件 `EZUIKitPlayer.EVENTS.resize`
 
 ```js
 // 监听resize事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.resize, () => {
   // {data: {"width": number,"height":number}}
-  console.log('resize', data);
+  console.log("resize", data);
 });
 ```
 
@@ -886,9 +888,9 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.resume, () => {
 });
 ```
 
-#### seek事件
+#### seek 事件
 
-seek事件 `EZUIKitPlayer.EVENTS.seek`， 仅支持回放
+seek 事件 `EZUIKitPlayer.EVENTS.seek`， 仅支持回放
 
 ```js
 // 监听seek事件
@@ -960,18 +962,21 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.recTimeChange, () => {
 // 监听获取云存储回片段事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getCloudRecTimes, (list) => {
   // {data: {"width": number,"height":number}}
-  console.log('list', list);
+  console.log("list", list);
 });
 ```
 
 获取云录制回片段事件 `EZUIKitPlayer.EVENTS.http.getCloudRecordTimes`
 
 ```js
 // 监听获取云录制回片段事件
-player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getCloudRecordTimes, (list) => {
-  // {data: {"width": number,"height":number}}
-  console.log('list', list);
-});
+player.eventEmitter.on(
+  EZUIKitPlayer.EVENTS.http.getCloudRecordTimes,
+  (list) => {
+    // {data: {"width": number,"height":number}}
+    console.log("list", list);
+  }
+);
 ```
 
 获取本地录制回片段事件 `EZUIKitPlayer.EVENTS.http.getLocalRecTimes`
@@ -980,7 +985,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getCloudRecordTimes, (list) =>
 // 监听获取本地录制回片段事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getLocalRecTimes, (list) => {
   // {data: {"width": number,"height":number}}
-  console.log('list', list);
+  console.log("list", list);
 });
 ```
 
@@ -990,7 +995,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getLocalRecTimes, (list) => {
 // 监听获取设备信息事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getDeviceInfo, (info) => {
   // {"deviceSerial":"BC7799091","deviceName":"前端设备勿动 C6Wi(BC7799091)","localName":"C6Wi(BC7799091)","model":"CS-C6Wi-8D8W2DF","status":1,"defence":0,"isEncrypt":0,"alarmSoundMode":2,"offlineNotify":0,"category":"C6Wi","parentCategory":"IPC","updateTime":1741763026000,"netType":"wireless","signal":"0%","riskLevel":0,"netAddress":"125.121.197.61"}
-  console.log('info', info);
+  console.log("info", info);
 });
 ```
 
@@ -1000,7 +1005,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getDeviceInfo, (info) => {
 // 监听获取设备信息事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.http.getDeviceList, (info) => {
   // {"deviceSerial":"BC7799091","deviceName":"前端设备勿动 C6Wi(BC7799091)","localName":"C6Wi(BC7799091)","model":"CS-C6Wi-8D8W2DF","status":1,"defence":0,"isEncrypt":0,"alarmSoundMode":2,"offlineNotify":0,"category":"C6Wi","parentCategory":"IPC","updateTime":1741763026000,"netType":"wireless","signal":"0%","riskLevel":0,"netAddress":"125.121.197.61"}
-  console.log('info', info);
+  console.log("info", info);
 });
 ```
 
@@ -1086,7 +1091,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.talkSuccess, () => {
 // 监听对讲开启失败事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.talkError, (error) => {
   // ...
-  console.error('talkError', error);
+  console.error("talkError", error);
 });
 ```
 
@@ -1137,7 +1142,7 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.zoom.closeZoom, () => {
 // 监听电子放大变化事件
 player.eventEmitter.on(EZUIKitPlayer.EVENTS.zoom.onZoomChange, (info) => {
   // {"zoom": string,"reset"?:boolean}
-  console.log('onZoomChange', info);
+  console.log("onZoomChange", info);
 });
 ```
 
@@ -1194,10 +1199,13 @@ player.eventEmitter.on(EZUIKitPlayer.EVENTS.ptz.ptzDirection, () => {
 
 ```js
 // 监听点击云台控制控件方向事件
-player.eventEmitter.on(EZUIKitPlayer.EVENTS.timeLine.timeWidthChange, (widthType) => {
-  // ...
-  console.log('timeWidthChange', widthType); // 0 | 1 | 2 | 3
-});
+player.eventEmitter.on(
+  EZUIKitPlayer.EVENTS.timeLine.timeWidthChange,
+  (widthType) => {
+    // ...
+    console.log("timeWidthChange", widthType); // 0 | 1 | 2 | 3
+  }
+);
 ```
 
 #### 日期选择器相关事件