@video-supply/dahua-player 0.1.3 → 0.1.5

package/README.md

@@ -58,7 +58,9 @@ player.sdk.playRecordVideo({
 });
 
 player.sdk.playSpeed(2, 0);
-player.sdk.jumpPlayByDateTime('2026-03-01 12:00:00', 0);
+await player.sdk.jumpPlayByDateTimeAsync('2026-03-01 12:00:00', 0, {
+  onDone: ({ timeSec }) => console.log('seek done', timeSec),
+});
 player.sdk.setFullScreen();
 ```
 
@@ -91,7 +93,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 +111,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`)
 
@@ -138,6 +171,18 @@ Returns: `DahuaPlayerInstance`
   - Seeks and plays at the given datetime (record mode only).
   - `datetime` supports `YYYY-MM-DD HH:mm:ss` string, `Date`, or epoch seconds/milliseconds.
   - `index` is the window index (defaults to 0).
+- `jumpPlayByDateTimeAsync(datetime: string | Date | number, index?: number, options?): Promise<{ timeMs, timeSec, windowIndex?, channelCode?, raw? }>`
+  - Record seek helper (record mode only).
+  - Resolves when playback time reaches the target (based on `getVideoFrameInfo`).
+  - Default timeout: 30s.
+  - Resolves with `{ timeMs, timeSec, windowIndex?, channelCode?, raw? }` (the matched playback-time payload).
+  - `options` supports two forms:
+    - callback form: `jumpPlayByDateTimeAsync(dt, idx, (payload) => {})` (same as `onDone`)
+    - object form:
+      - `timeoutMs?: number` (default 30000)
+      - `toleranceMs?: number` (default 1500)
+      - `onDone?: (payload) => void` (called before resolve)
+  - Rejects on timeout / destroyed / underlying SDK error (also reported via `onError` / `error` event).
 - `playSpeed(speed: number, index: number): void`
   - Sets record playback speed (record mode only).
   - Allowed speeds: `0.125/0.25/0.5/1/1.25/1.5/2/4/8`.
@@ -308,6 +353,8 @@ await player.ready;
   - `onReady`：内核初始化完成（不等同于播放成功）
   - `onPlay`：播放成功（包含 real/record）
   - `onPause`：暂停
+  - `onPlaybackTime`：回放当前时间变化（仅 mode=record，默认按秒变化触发）
+    - payload：`{ timeMs, timeSec, windowIndex?, channelCode?, raw? }`
   - `onError`：初始化/播放等错误
   - `onDestroy`：销毁
   - `onSdkMessage`：透出 WSPlayer 原始消息（排障用）
@@ -329,8 +376,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`：
 
@@ -163,6 +201,18 @@ await instance.ready;
     - `Date`
     - `number`：时间戳（秒或毫秒，内部会自动兼容）
   - `index`：窗口索引（默认窗口 0）
+- `jumpPlayByDateTimeAsync(datetime: string | Date | number, index?: number, options?): Promise<{ timeMs, timeSec, windowIndex?, channelCode?, raw? }>`
+  - 录像跳转播放（仅 `mode=record` 可用）
+  - 内部基于回放时间（`getVideoFrameInfo`）判断跳转是否完成
+  - 默认超时：30 秒
+  - 返回：Promise resolve 为 `{ timeMs, timeSec, windowIndex?, channelCode?, raw? }`（命中目标时间点时的回放时间 payload）
+  - `options` 支持两种写法：
+    - 直接传回调函数：`jumpPlayByDateTimeAsync(dt, idx, (payload) => {})`（等价于 `onDone`）
+    - 传配置对象：
+      - `timeoutMs?: number`：超时时间（默认 30000）
+      - `toleranceMs?: number`：时间命中容差（默认 1500）
+      - `onDone?: (payload) => void`：跳转完成回调（在 Promise resolve 前触发）
+  - reject 场景：超时 / 播放器销毁 / SDK 抛错（会触发 `onError`/`error` 事件）
 - `playSpeed(speed: number, index: number): void`
   - 设置录像回放倍速（仅 `mode=record` 可用）
   - `speed` 支持：`0.125/0.25/0.5/1/1.25/1.5/2/4/8`
@@ -198,5 +248,7 @@ player.sdk.playRecordVideo({
 });
 
 player.sdk.playSpeed(2, 0);
-player.sdk.jumpPlayByDateTime('2026-03-01 12:00:00', 0);
+await player.sdk.jumpPlayByDateTimeAsync('2026-03-01 12:00:00', 0, {
+  onDone: ({ timeSec }) => console.log('跳转完成', timeSec),
+});
 ```

package/dist/index.cjs

@@ -741,6 +741,64 @@ 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/sdk/DateTime.ts
+function parseDateTimeToMs(datetime) {
+  if (typeof datetime === "number") {
+    if (!Number.isFinite(datetime)) return NaN;
+    return Math.floor(datetime > 1e12 ? datetime : datetime * 1e3);
+  }
+  if (datetime instanceof Date) {
+    const ms2 = datetime.getTime();
+    return Number.isFinite(ms2) ? Math.floor(ms2) : NaN;
+  }
+  const raw = (datetime || "").trim();
+  if (!raw) return NaN;
+  const v = raw.includes("T") ? raw : raw.replace(" ", "T");
+  const m = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})$/.exec(v);
+  if (!m) {
+    const ms2 = new Date(v).getTime();
+    return Number.isFinite(ms2) ? Math.floor(ms2) : NaN;
+  }
+  const y = Number(m[1]);
+  const mon = Number(m[2]);
+  const d = Number(m[3]);
+  const hh = Number(m[4]);
+  const mm = Number(m[5]);
+  const ss = Number(m[6]);
+  const dt = new Date(y, mon - 1, d, hh, mm, ss, 0);
+  const ms = dt.getTime();
+  return Number.isFinite(ms) ? Math.floor(ms) : NaN;
+}
+
 // src/DahuaPlayer.ts
 function normalizeStaticPath(path) {
   const raw = (path || "").trim();
@@ -912,6 +970,10 @@ var DahuaPlayer = class {
     };
     let readyReject = () => {
     };
+    let lastPlaybackTimeMs = null;
+    let lastEmittedPlaybackTimeSec = null;
+    const jumpWaiters = [];
+    let jumpWaiterId = 0;
     const safeOnError = (e) => {
       var _a2;
       try {
@@ -920,6 +982,29 @@ var DahuaPlayer = class {
       }
       emit(listeners, "error", e);
     };
+    const createDestroyedError = () => new DahuaPlayerError({
+      code: "DESTROYED" /* DESTROYED */,
+      message: "destroyed",
+      userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
+    });
+    const createNotReadyError = () => new DahuaPlayerError({
+      code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
+      message: "player not ready",
+      userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
+    });
+    const requireAdapter = () => {
+      if (destroyed) {
+        const err = createDestroyedError();
+        safeOnError(err);
+        throw err;
+      }
+      if (!adapter) {
+        const err = createNotReadyError();
+        safeOnError(err);
+        throw err;
+      }
+      return adapter;
+    };
     const tryAutoPlay = () => {
       if (!autoPlay) return;
       if (mode === "real") {
@@ -993,11 +1078,41 @@ var DahuaPlayer = class {
           playerOptions: opts.playerOptions,
           debug: opts.debug,
           onMessage: (type, data) => {
-            var _a3;
+            var _a3, _b2, _c2;
             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);
+              }
+              if (jumpWaiters.length > 0) {
+                for (let i = jumpWaiters.length - 1; i >= 0; i--) {
+                  const w = jumpWaiters[i];
+                  if (typeof w.index === "number" && typeof payload.windowIndex === "number" && w.index !== payload.windowIndex) {
+                    continue;
+                  }
+                  if (Math.abs(payload.timeMs - w.targetMs) <= w.toleranceMs) {
+                    jumpWaiters.splice(i, 1);
+                    clearTimeout(w.timeoutTimer);
+                    try {
+                      (_c2 = w.onDone) == null ? void 0 : _c2.call(w, payload);
+                    } catch {
+                    }
+                    w.resolve(payload);
+                  }
+                }
+              }
+            }
           },
           emit: (event, payload) => {
             var _a3, _b2, _c2;
@@ -1034,6 +1149,13 @@ var DahuaPlayer = class {
             }
             if (event === "error") {
               const msg = formatUserMessage(payload, "\u64AD\u653E\u5931\u8D25");
+              if (jumpWaiters.length > 0) {
+                const waiters = jumpWaiters.splice(0, jumpWaiters.length);
+                for (const w of waiters) {
+                  clearTimeout(w.timeoutTimer);
+                  w.reject(payload);
+                }
+              }
               if (payload instanceof DahuaPlayerError) {
                 const initCodes = /* @__PURE__ */ new Set([
                   "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
@@ -1065,6 +1187,7 @@ var DahuaPlayer = class {
         readyReject(err);
       }
     })();
+    const getPlaybackTimeMs = () => lastPlaybackTimeMs;
     const instance = {
       id,
       ready,
@@ -1077,6 +1200,7 @@ var DahuaPlayer = class {
         if (!adapter) return;
         adapter.pause();
       },
+      getPlaybackTimeMs,
       /**
        * 销毁播放器实例并释放资源。
        *
@@ -1090,6 +1214,14 @@ var DahuaPlayer = class {
         if (destroyed) return;
         destroyed = true;
         clearTimeout(readyTimer);
+        if (jumpWaiters.length > 0) {
+          const waiters = jumpWaiters.splice(0, jumpWaiters.length);
+          const err = createDestroyedError();
+          for (const w of waiters) {
+            clearTimeout(w.timeoutTimer);
+            w.reject(err);
+          }
+        }
         if (transientOverlayTimer) {
           clearTimeout(transientOverlayTimer);
           transientOverlayTimer = null;
@@ -1130,26 +1262,9 @@ var DahuaPlayer = class {
       sdk: {
         getRaw: () => adapter == null ? void 0 : adapter.getRaw(),
         callRaw: (method, ...args) => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err);
-            throw err;
-          }
-          if (!adapter) {
-            const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err);
-            throw err;
-          }
+          const ad = requireAdapter();
           try {
-            return adapter.callRaw(method, ...args);
+            return ad.callRaw(method, ...args);
           } catch (e) {
             const err = toDahuaError(e, {
               code: "PLAY_FAILED" /* PLAY_FAILED */,
@@ -1161,27 +1276,10 @@ var DahuaPlayer = class {
           }
         },
         playRealVideo: (opt) => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err);
-            throw err;
-          }
-          if (!adapter) {
-            const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err);
-            throw err;
-          }
+          const ad = requireAdapter();
           showLoading("\u52A0\u8F7D\u89C6\u9891\u4E2D\u2026");
           try {
-            adapter.playRealVideo(opt);
+            ad.playRealVideo(opt);
           } catch (e) {
             setLoading(false);
             const err = toDahuaError(e, {
@@ -1194,27 +1292,10 @@ var DahuaPlayer = class {
           }
         },
         playRecordVideo: (opt) => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err);
-            throw err;
-          }
-          if (!adapter) {
-            const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err);
-            throw err;
-          }
+          const ad = requireAdapter();
           showLoading("\u52A0\u8F7D\u5F55\u50CF\u4E2D\u2026");
           try {
-            adapter.playRecordVideo(opt);
+            ad.playRecordVideo(opt);
           } catch (e) {
             setLoading(false);
             const err = toDahuaError(e, {
@@ -1230,26 +1311,9 @@ var DahuaPlayer = class {
         play: (windowIndex) => adapter == null ? void 0 : adapter.playWindow(windowIndex),
         close: (windowIndex) => adapter == null ? void 0 : adapter.closeWindow(windowIndex),
         setPlayerNum: (n) => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err);
-            throw err;
-          }
-          if (!adapter) {
-            const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err);
-            throw err;
-          }
+          const ad = requireAdapter();
           try {
-            adapter.setPlayerNum(n);
+            ad.setPlayerNum(n);
           } catch (e) {
             const err = toDahuaError(e, {
               code: "PLAY_FAILED" /* PLAY_FAILED */,
@@ -1261,28 +1325,84 @@ var DahuaPlayer = class {
           }
         },
         jumpPlayByDateTime: (datetime, index) => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
+          const ad = requireAdapter();
+          showLoading("\u8DF3\u8F6C\u4E2D\u2026");
+          try {
+            ad.jumpPlayByDateTime(datetime, index);
+          } catch (e) {
+            setLoading(false);
+            const err = toDahuaError(e, {
+              code: "PLAY_FAILED" /* PLAY_FAILED */,
+              message: "jumpPlayByDateTime failed",
+              userMessage: "\u5F55\u50CF\u8DF3\u8F6C\u64AD\u653E\u5931\u8D25"
             });
             safeOnError(err);
             throw err;
           }
-          if (!adapter) {
+        },
+        jumpPlayByDateTimeAsync: (datetime, index, options2) => {
+          let ad;
+          try {
+            ad = requireAdapter();
+          } catch (e) {
+            return Promise.reject(e);
+          }
+          const onDone = typeof options2 === "function" ? options2 : options2 == null ? void 0 : options2.onDone;
+          const timeoutMs = typeof options2 === "object" && options2 && Number.isFinite(options2.timeoutMs) ? Math.floor(Number(options2.timeoutMs)) : 3e4;
+          const toleranceMs = typeof options2 === "object" && options2 && Number.isFinite(options2.toleranceMs) ? Math.floor(Number(options2.toleranceMs)) : 1500;
+          const targetMs = parseDateTimeToMs(datetime);
+          if (!Number.isFinite(targetMs)) {
             const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
+              code: "PLAY_FAILED" /* PLAY_FAILED */,
+              message: "invalid datetime",
+              userMessage: "\u8DF3\u8F6C\u65F6\u95F4\u683C\u5F0F\u4E0D\u5408\u6CD5",
+              cause: { datetime }
             });
             safeOnError(err);
-            throw err;
+            return Promise.reject(err);
           }
           showLoading("\u8DF3\u8F6C\u4E2D\u2026");
+          const idx = typeof index === "number" ? Math.floor(index) : void 0;
+          const id2 = ++jumpWaiterId;
+          const p = new Promise((resolve, reject) => {
+            const timeoutTimer = setTimeout(() => {
+              const at = jumpWaiters.findIndex((w) => w.id === id2);
+              if (at >= 0) jumpWaiters.splice(at, 1);
+              setLoading(false);
+              const err = new DahuaPlayerError({
+                code: "PLAY_FAILED" /* PLAY_FAILED */,
+                message: "jumpPlayByDateTimeAsync timeout",
+                userMessage: "\u5F55\u50CF\u8DF3\u8F6C\u8D85\u65F6",
+                cause: { timeoutMs, datetime, index: idx }
+              });
+              safeOnError(err);
+              reject(err);
+            }, Math.max(0, timeoutMs));
+            jumpWaiters.push({
+              id: id2,
+              targetMs,
+              toleranceMs: Math.max(0, toleranceMs),
+              index: idx,
+              timeoutTimer,
+              onDone,
+              resolve: (payload) => {
+                setLoading(false);
+                resolve(payload);
+              },
+              reject: (e) => {
+                setLoading(false);
+                reject(e);
+              }
+            });
+          });
           try {
-            adapter.jumpPlayByDateTime(datetime, index);
+            ad.jumpPlayByDateTime(datetime, idx);
           } catch (e) {
+            const at = jumpWaiters.findIndex((w) => w.id === id2);
+            if (at >= 0) {
+              const w = jumpWaiters.splice(at, 1)[0];
+              clearTimeout(w.timeoutTimer);
+            }
             setLoading(false);
             const err = toDahuaError(e, {
               code: "PLAY_FAILED" /* PLAY_FAILED */,
@@ -1290,30 +1410,14 @@ var DahuaPlayer = class {
               userMessage: "\u5F55\u50CF\u8DF3\u8F6C\u64AD\u653E\u5931\u8D25"
             });
             safeOnError(err);
-            throw err;
+            return Promise.reject(err);
           }
+          return p;
         },
         playSpeed: (speed, index) => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err);
-            throw err;
-          }
-          if (!adapter) {
-            const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err);
-            throw err;
-          }
+          const ad = requireAdapter();
           try {
-            adapter.playSpeed(speed, index);
+            ad.playSpeed(speed, index);
           } catch (e) {
             const err = toDahuaError(e, {
               code: "PLAY_FAILED" /* PLAY_FAILED */,
@@ -1325,26 +1429,9 @@ var DahuaPlayer = class {
           }
         },
         setFullScreen: () => {
-          if (destroyed) {
-            const err = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err);
-            throw err;
-          }
-          if (!adapter) {
-            const err = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err);
-            throw err;
-          }
+          const ad = requireAdapter();
           try {
-            adapter.setFullScreen();
+            ad.setFullScreen();
             return;
           } catch {
           }
@@ -1362,26 +1449,9 @@ var DahuaPlayer = class {
           void req.call(el);
         },
         setExitFullScreen: () => {
-          if (destroyed) {
-            const err2 = new DahuaPlayerError({
-              code: "DESTROYED" /* DESTROYED */,
-              message: "destroyed",
-              userMessage: "\u64AD\u653E\u5668\u5DF2\u9500\u6BC1"
-            });
-            safeOnError(err2);
-            throw err2;
-          }
-          if (!adapter) {
-            const err2 = new DahuaPlayerError({
-              code: "SDK_INIT_FAILED" /* SDK_INIT_FAILED */,
-              message: "player not ready",
-              userMessage: "\u64AD\u653E\u5668\u672A\u5C31\u7EEA\uFF0C\u8BF7\u7B49\u5F85 ready \u540E\u518D\u8C03\u7528"
-            });
-            safeOnError(err2);
-            throw err2;
-          }
+          const ad = requireAdapter();
           try {
-            adapter.setExitFullScreen();
+            ad.setExitFullScreen();
             return;
           } catch {
           }