@video-supply/dahua-player 0.1.2 → 0.1.4

package/README.md

@@ -91,7 +91,9 @@ Optional:
 - `staticPath?: string` (default `/wsplayer-gov`)
 - `sdkUrl?: string` (default `/wsplayer-gov/wsplayer.min.js`)
 - `debug?: boolean` (default `false`)
-- callbacks: `onReady/onPlay/onPause/onError/onDestroy`
+- callbacks: `onReady/onPlay/onPause/onPlaybackTime/onError/onDestroy`
+  - `onPlaybackTime(payload)` is record-mode only and fires when `timeSec` changes (about once per second).
+  - payload: `{ timeMs, timeSec, windowIndex?, channelCode?, raw? }`
 
 Returns: `DahuaPlayerInstance`
 
@@ -107,8 +109,37 @@ Returns: `DahuaPlayerInstance`
   - Destroys the instance and releases resources.
   - Removes DOM nodes, clears timers, and releases sessionStorage shims.
 - `on(event, handler) / off(event, handler)`
-  - Subscribe/unsubscribe events: `ready` / `play` / `pause` / `error` / `destroy`.
+  - Subscribe/unsubscribe events: `ready` / `play` / `pause` / `playbackTime` / `error` / `destroy`.
   - `play` payload: `{ mode?: 'real' | 'record' }`.
+- `getPlaybackTimeMs(): number | null`
+  - Returns the latest playback time in epoch milliseconds (record mode only).
+  - Returns `null` before the first playback timestamp arrives.
+
+#### Playback time example (callback + imperative getter)
+
+```ts
+const player = DahuaPlayer.init({
+  container: 'player',
+  auth: { token: 'YOUR_DAHUA_TOKEN' },
+  mode: 'record',
+  onPlaybackTime: ({ timeMs, timeSec }) => {
+    console.log('playback time changed:', timeSec, timeMs);
+  },
+});
+
+await player.ready;
+
+player.on('playbackTime', ({ timeMs, timeSec }) => {
+  console.log('playbackTime event:', timeSec, timeMs);
+});
+
+player.sdk.playRecordVideo({
+  startTime: Math.floor(Date.now() / 1000) - 60,
+  endTime: Math.floor(Date.now() / 1000),
+});
+
+console.log('getPlaybackTimeMs:', player.getPlaybackTimeMs());
+```
 
 #### SDK methods (`instance.sdk`)
 
@@ -308,6 +339,8 @@ await player.ready;
   - `onReady`：内核初始化完成（不等同于播放成功）
   - `onPlay`：播放成功（包含 real/record）
   - `onPause`：暂停
+  - `onPlaybackTime`：回放当前时间变化（仅 mode=record，默认按秒变化触发）
+    - payload：`{ timeMs, timeSec, windowIndex?, channelCode?, raw? }`
   - `onError`：初始化/播放等错误
   - `onDestroy`：销毁
   - `onSdkMessage`：透出 WSPlayer 原始消息（排障用）
@@ -329,8 +362,11 @@ await instance.ready;
   - 销毁播放器实例并释放资源
   - 会移除 DOM、清理定时器、释放 sessionStorage shim
 - `instance.on(event, handler) / instance.off(event, handler)`
-  - 订阅/取消订阅事件：`ready` / `play` / `pause` / `error` / `destroy`
+  - 订阅/取消订阅事件：`ready` / `play` / `pause` / `playbackTime` / `error` / `destroy`
   - `play` 事件 payload：`{ mode?: 'real' | 'record' }`
+- `instance.getPlaybackTimeMs(): number | null`
+  - 主动获取最近一次收到的“当前回放时间（epoch ms）”
+  - 仅 mode=record 时有意义；未收到回放时间前返回 null
 
 `instance.sdk`：
 

package/README.zh-CN.md

@@ -107,6 +107,14 @@ await player.ready;
   - `onReady`：内核初始化完成（不等同于播放成功）
   - `onPlay`：播放成功（包含 real/record）
   - `onPause`：暂停
+  - `onPlaybackTime`：回放当前时间变化（仅 mode=record，默认按秒变化触发）
+    - 触发时机：底层 SDK 会高频推送回放帧信息；库内部只在 `timeSec` 变化时对外触发（约 1 次/秒）
+    - payload：`{ timeMs, timeSec, windowIndex?, channelCode?, raw? }`
+      - `timeMs`：当前回放时间（epoch 毫秒）
+      - `timeSec`：当前回放时间（epoch 秒）
+      - `windowIndex`：窗口索引（可选）
+      - `channelCode`：通道编码（可选）
+      - `raw`：原始 SDK data（可选，用于排障）
   - `onError`：初始化/播放等错误
   - `onDestroy`：销毁
   - `onSdkMessage`：透出 WSPlayer 原始消息（排障用）
@@ -128,8 +136,38 @@ await instance.ready;
   - 销毁播放器实例并释放资源
   - 会移除 DOM、清理定时器、释放 sessionStorage shim
 - `instance.on(event, handler) / instance.off(event, handler)`
-  - 订阅/取消订阅事件：`ready` / `play` / `pause` / `error` / `destroy`
+  - 订阅/取消订阅事件：`ready` / `play` / `pause` / `playbackTime` / `error` / `destroy`
   - `play` 事件 payload：`{ mode?: 'real' | 'record' }`
+- `instance.getPlaybackTimeMs(): number | null`
+  - 主动获取最近一次收到的“当前回放时间（epoch ms）”
+  - 仅 mode=record 时有意义；未收到回放时间前返回 null
+
+### 回放时间示例（回调 + 主动获取）
+
+```ts
+const player = DahuaPlayer.init({
+  container: 'player',
+  auth: { token: 'YOUR_DAHUA_TOKEN' },
+  mode: 'record',
+  onPlaybackTime: ({ timeMs, timeSec, windowIndex, channelCode }) => {
+    console.log('回放时间变化(秒级触发)：', timeSec, timeMs, windowIndex, channelCode);
+  },
+});
+
+await player.ready;
+
+player.on('playbackTime', ({ timeMs, timeSec }) => {
+  console.log('playbackTime 事件：', timeSec, timeMs);
+});
+
+player.sdk.playRecordVideo({
+  startTime: Math.floor(Date.now() / 1000) - 60,
+  endTime: Math.floor(Date.now() / 1000),
+});
+
+const t = player.getPlaybackTimeMs();
+console.log('主动获取(可能为null)：', t);
+```
 
 `instance.sdk`：
 

package/dist/index.cjs

@@ -250,6 +250,7 @@ var PlayerAdapter = class {
     this.playerManager = null;
     this.destroyed = false;
     this.readyResolved = false;
+    this.lastStatus = null;
     this.currentNum = 1;
     this.currentMaxNum = 1;
     this.opts = opts;
@@ -356,8 +357,17 @@ var PlayerAdapter = class {
         return;
       }
       case "statusChanged": {
-        if (data && typeof data === "object" && (data.status === "pause" || data.status === "paused")) {
-          this.opts.emit("pause");
+        const status = data && typeof data === "object" ? data.status : void 0;
+        if (typeof status === "string" && status && status !== this.lastStatus) {
+          this.lastStatus = status;
+          if (status === "pause" || status === "paused") {
+            this.opts.emit("pause");
+            return;
+          }
+          if (status === "playing") {
+            this.opts.emit("play", { mode: this.opts.mode });
+            return;
+          }
         }
         return;
       }
@@ -676,8 +686,8 @@ var PlayerAdapter = class {
         this.playerManager.pause(0);
       } else if (typeof this.playerManager.close === "function") {
         this.playerManager.close(0);
+        this.opts.emit("pause");
       }
-      this.opts.emit("pause");
     } catch {
     }
   }
@@ -690,8 +700,8 @@ var PlayerAdapter = class {
         this.playerManager.pause(idx);
       } else if (typeof this.playerManager.close === "function") {
         this.playerManager.close(idx);
+        this.opts.emit("pause");
       }
-      this.opts.emit("pause");
     } catch {
     }
   }
@@ -731,6 +741,35 @@ var PlayerAdapter = class {
   }
 };
 
+// src/sdk/PlaybackTime.ts
+function extractPlaybackTimeMsFromFrameInfo(data) {
+  const vf = data && typeof data === "object" ? data.videoFrameInfo : void 0;
+  const utcMsRaw = vf && typeof vf === "object" ? vf.utcTimeStamp : void 0;
+  const secRaw = data && typeof data === "object" ? data.timeStamp : void 0;
+  const utcMs = typeof utcMsRaw === "number" && Number.isFinite(utcMsRaw) ? Math.floor(utcMsRaw) : null;
+  const sec = typeof secRaw === "number" && Number.isFinite(secRaw) ? Math.floor(secRaw) : null;
+  const baseMs = utcMs != null ? utcMs : sec != null ? sec * 1e3 : null;
+  if (baseMs == null) return null;
+  const shouldApplySubMs = utcMs == null ? true : utcMs % 1e3 === 0;
+  if (!shouldApplySubMs) return baseMs;
+  const nTimeStampRaw = vf && typeof vf === "object" ? vf.nTimeStamp : void 0;
+  if (typeof nTimeStampRaw !== "number" || !Number.isFinite(nTimeStampRaw)) return baseMs;
+  const sub = (Math.floor(nTimeStampRaw) % 1e3 + 1e3) % 1e3;
+  return baseMs + sub;
+}
+function buildPlaybackTimePayloadFromFrameInfo(data) {
+  var _a;
+  const timeMs = extractPlaybackTimeMsFromFrameInfo(data);
+  if (timeMs == null) return null;
+  const secRaw = data && typeof data === "object" ? data.timeStamp : void 0;
+  const timeSec = typeof secRaw === "number" && Number.isFinite(secRaw) ? Math.floor(secRaw) : Math.floor(timeMs / 1e3);
+  const idxRaw = data && typeof data === "object" ? data.selectIndex : void 0;
+  const windowIndex = typeof idxRaw === "number" && Number.isFinite(idxRaw) ? Math.floor(idxRaw) : void 0;
+  const channelCodeRaw = data && typeof data === "object" ? (_a = data.channelData) == null ? void 0 : _a.channelCode : void 0;
+  const channelCode = typeof channelCodeRaw === "string" ? channelCodeRaw : void 0;
+  return { timeMs, timeSec, windowIndex, channelCode, raw: data };
+}
+
 // src/DahuaPlayer.ts
 function normalizeStaticPath(path) {
   const raw = (path || "").trim();
@@ -902,6 +941,8 @@ var DahuaPlayer = class {
     };
     let readyReject = () => {
     };
+    let lastPlaybackTimeMs = null;
+    let lastEmittedPlaybackTimeSec = null;
     const safeOnError = (e) => {
       var _a2;
       try {
@@ -983,11 +1024,24 @@ var DahuaPlayer = class {
           playerOptions: opts.playerOptions,
           debug: opts.debug,
           onMessage: (type, data) => {
-            var _a3;
+            var _a3, _b2;
             try {
               (_a3 = opts.onSdkMessage) == null ? void 0 : _a3.call(opts, type, data);
             } catch {
             }
+            if (type === "getVideoFrameInfo") {
+              const payload = buildPlaybackTimePayloadFromFrameInfo(data);
+              if (!payload) return;
+              lastPlaybackTimeMs = payload.timeMs;
+              if (payload.timeSec !== lastEmittedPlaybackTimeSec) {
+                lastEmittedPlaybackTimeSec = payload.timeSec;
+                try {
+                  (_b2 = opts.onPlaybackTime) == null ? void 0 : _b2.call(opts, payload);
+                } catch {
+                }
+                emit(listeners, "playbackTime", payload);
+              }
+            }
           },
           emit: (event, payload) => {
             var _a3, _b2, _c2;
@@ -1055,6 +1109,7 @@ var DahuaPlayer = class {
         readyReject(err);
       }
     })();
+    const getPlaybackTimeMs = () => lastPlaybackTimeMs;
     const instance = {
       id,
       ready,
@@ -1067,6 +1122,7 @@ var DahuaPlayer = class {
         if (!adapter) return;
         adapter.pause();
       },
+      getPlaybackTimeMs,
       /**
        * 销毁播放器实例并释放资源。
        *