xxf_react 0.9.1 → 0.9.2

package/dist/media/video-play-safe.d.ts

@@ -2,6 +2,15 @@
  * Video 安全播放扩展
  * 处理移动端自动播放限制，自动降级为静音播放
  */
+/** 播放失败信息 */
+export interface PlayErrorInfo {
+    url: string;
+    error: Error;
+}
+/** 全局播放失败监听器类型 */
+export type PlayErrorListener = (info: PlayErrorInfo) => void;
+/** 设置全局播放失败监听 */
+export declare function setPlayErrorListener(listener: PlayErrorListener | null): void;
 export interface PlaySafeOptions {
     /** 是否在非静音播放失败时降级为静音重试，默认 true */
     mutedRetry?: boolean;

package/dist/media/video-play-safe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video-play-safe.d.ts","sourceRoot":"","sources":["../../src/media/video-play-safe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC5B,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAGD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,gBAAgB;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtD;CACJ;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC1B,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC"}
+{"version":3,"file":"video-play-safe.d.ts","sourceRoot":"","sources":["../../src/media/video-play-safe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,aAAa;AACb,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CAChB;AAED,kBAAkB;AAClB,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;AAK9D,iBAAiB;AACjB,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE7E;AAOD,MAAM,WAAW,eAAe;IAC5B,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC9B;AAGD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,gBAAgB;QACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtD;CACJ;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC1B,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE,eAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC"}

package/dist/media/video-play-safe.js

@@ -2,6 +2,16 @@
  * Video 安全播放扩展
  * 处理移动端自动播放限制，自动降级为静音播放
  */
+/** 全局监听器 */
+let globalErrorListener = null;
+/** 设置全局播放失败监听 */
+export function setPlayErrorListener(listener) {
+    globalErrorListener = listener;
+}
+/** 通知监听器 */
+function notifyPlayError(info) {
+    globalErrorListener === null || globalErrorListener === void 0 ? void 0 : globalErrorListener(info);
+}
 /**
  * 安全播放视频
  * 1. 按当前 video.muted 状态尝试播放
@@ -13,28 +23,43 @@ export async function playSafe(video, options = {}) {
         return;
     }
     const wasMuted = video.muted;
+    const videoUrl = video.currentSrc || video.src || '';
     try {
         await video.play();
     }
     catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
         // 处理自动播放被阻止的错误
         // - NotAllowedError: Chrome/Firefox 自动播放策略阻止
         // - AbortError: Safari/iOS 自动播放策略阻止（包括低电量模式）
-        const isAutoplayBlocked = error instanceof Error &&
-            (error.name === 'NotAllowedError' || error.name === 'AbortError');
+        const isAutoplayBlocked = err.name === 'NotAllowedError' || err.name === 'AbortError';
         if (!isAutoplayBlocked) {
-            throw error;
+            // 非自动播放阻止的错误，通知全局监听器
+            notifyPlayError({ url: videoUrl, error: err });
+            throw err;
         }
         // 不启用静音重试，直接抛出
-        if (!mutedRetry)
-            throw error;
+        if (!mutedRetry) {
+            notifyPlayError({ url: videoUrl, error: err });
+            throw err;
+        }
         // 已经是静音还失败，直接抛出
-        if (wasMuted)
-            throw error;
+        if (wasMuted) {
+            notifyPlayError({ url: videoUrl, error: err });
+            throw err;
+        }
         // 降级为静音播放
         video.muted = true;
         onMutedChange === null || onMutedChange === void 0 ? void 0 : onMutedChange();
-        await video.play();
+        try {
+            await video.play();
+        }
+        catch (retryError) {
+            // 静音重试也失败，通知全局监听器
+            const retryErr = retryError instanceof Error ? retryError : new Error(String(retryError));
+            notifyPlayError({ url: videoUrl, error: retryErr });
+            throw retryErr;
+        }
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xxf_react",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "private": false,
   "type": "module",
   "main": "dist/index.js",