mn-video-player-v2 1.4.9 → 1.5.0

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "mn-video-player-v2",
-  "version": "1.4.9",
+  "version": "1.5.0",
   "description": "MN Video Player for WebSocket streaming",
-  "main": "./dist/mn-video-player.umd.js",
-  "module": "./dist/mn-video-player.es.js",
+  "main": "./dist/mn-video-player-v2.umd.js",
+  "module": "./dist/mn-video-player-v2.es.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {

package/readme.md

@@ -4,14 +4,14 @@
 
 MnVideoPlayer 是一个基于 WebSocket 的视频播放器，支持实时播放、历史回放、对讲等功能。
 
-在项目中使用时，需要排除 `mn-video-player` 模块的预加载，以避免与 Worker文件资源获取失败。
+在项目中使用时，需要排除 `mn-video-player-v2` 模块的预加载，以避免与 Worker文件资源获取失败。
 
 ```javascript
 // 示例：Vue 项目配置
 module.exports = {
   // ... 其他配置
   optimizeDeps: {
-    exclude: ['mn-video-player']
+    exclude: ['mn-video-player-v2']
   },
 };
 ```
@@ -39,6 +39,7 @@ module.exports = {
 | streamType | number | 否 | 码流类型 实时：（0=主码流，1=子码流） 回放：（1=主码流，2=子码流） |
 | renderType | string | 否 | 渲染类型（wasm 或 decode） 使用wasm解码 回放时建议使用decode |
 | showControlBar | boolean | 否 | 是否显示内置控制栏（默认 true） |
+| debug | boolean | 否 | 是否显示调试信息悬浮层（时间戳、fps、延迟、网速等，每 1 秒刷新，默认 false） |
 | enableDoubleClickFullscreen | boolean | 否 | 是否启用双击全屏（默认 true） |
 | controlCallbackFn | (type: MnVideoPlayerControlType) => boolean | 否 | 控制回调函数，返回 false 则阻止默认行为 ，返回 true 则执行默认行为 MnVideoPlayerControlType 枚举值 ： refresh 刷新  close 关闭  fullscreen 全屏/退出全屏  stream 切换码流  speedDec 降低倍速  speedInc 增加倍速 |
 
@@ -268,6 +269,50 @@ player.timeCallBack((time) => {
 });
 ```
 
+### netSpeedCallback 属性
+
+设置网速回调函数，播放时周期性收到网速数据。与 `timeCallBack` 不同，该回调直接赋值给 player 实例。
+
+**参数：**
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| kbPerSec | number | 网速（KB/s） |
+| frame | object | 原始网速帧对象，含 `d`（本周期字节数）、`len`（缓存帧数）等 |
+
+**示例：**
+
+```javascript
+player.netSpeedCallback = (kbPerSec, frame) => {
+    console.log('当前网速:', kbPerSec, 'KB/s');
+    console.log('缓存帧数:', frame.len);
+};
+```
+
+## 调试功能
+
+### debug 选项
+
+初始化时设置 `debug: true`，会在视频左上角悬浮显示实时调试信息（每 1 秒刷新）：
+
+- **时间**：当前播放时间戳
+- **fps**：实际出帧率
+- **延迟**：帧输出相对应播时刻的平均/最大滞后（ms），流畅时接近 0
+- **网速**：KB/s 及缓存帧数
+- **帧数 / 缓存队列**：本秒输出帧数与播放队列排队帧数
+- **模式**：wasm / VideoDecoder
+
+**示例：**
+
+```javascript
+player.init({
+    // ...其他参数
+    debug: true
+});
+```
+
+如需自行展示，也可通过 `player.timerCtrl.perfSnapshot()` 获取 fps/延迟统计（返回 `{ fps, avgLatency, maxLatency, frames, cache }`），取完后调用 `player.timerCtrl.perfReset()` 重置统计窗口。
+
 
 
 ## 完整示例
@@ -275,7 +320,7 @@ player.timeCallBack((time) => {
 ### 实时播放示例
 
 ```javascript
-import MnVideoPlayer from 'mn-video-player'
+import MnVideoPlayer from 'mn-video-player-v2'
 
 const player = new MnVideoPlayer();
 
@@ -301,7 +346,7 @@ player.play({
 ### 历史回放示例
 
 ```javascript
-import MnVideoPlayer from 'mn-video-player'
+import MnVideoPlayer from 'mn-video-player-v2'
 
 const player = new MnVideoPlayer();
 
@@ -329,7 +374,7 @@ player.play({
 ### 完整控制示例
 
 ```javascript
-import MnVideoPlayer from 'mn-video-player'
+import MnVideoPlayer from 'mn-video-player-v2'
 
 const player = new MnVideoPlayer();