@xmov/avatar 2.0.0-beta.13 → 2.0.0-beta.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmov/avatar",
-  "version": "2.0.0-beta.13",
+  "version": "2.0.0-beta.14",
   "description": "魔珐数字人 JS-SDK",
   "type": "module",
   "source": "src/index.ts",

package/src/utils/capability-checker.ts

@@ -110,17 +110,27 @@ function checkAudioSystemSync(): ICapabilityCheckItem {
 
 /**
  * 同步检查 WebCodecs API 是否存在（不探测具体编解码器）
+ * 
+ * 与 streaming-video.ts 解码策略一致标注平台解码路径：
+ * - Android（含 OpenHarmony/ArkWeb）：prefer-software 软解码
+ * - 其余环境：默认配置（硬解码）
+ * 实际解码配置支持度由异步 checkWebCodecsDetailed 探测
  */
 function checkWebCodecsSync(): ICapabilityCheckItem {
   const hasVideoDecoder = typeof (window as any).VideoDecoder !== 'undefined';
-  const supported = hasVideoDecoder;
+  const userAgent = (navigator.userAgent || '').toLowerCase();
+  const isAndroid = /android/.test(userAgent) || /openharmony|arkweb/.test(userAgent);
 
   return {
     name: 'webcodecs',
-    supported,
+    supported: hasVideoDecoder,
     severity: 'fatal',
-    reason: supported ? undefined : '浏览器不支持 WebCodecs VideoDecoder API',
-    detail: { hasVideoDecoder },
+    reason: hasVideoDecoder ? undefined : '浏览器不支持 WebCodecs VideoDecoder API',
+    detail: {
+      hasVideoDecoder,
+      isAndroid,
+      hardwareAcceleration: isAndroid ? 'prefer-software' : 'default',
+    },
   };
 }
 
@@ -186,13 +196,17 @@ export function checkCapabilitySync(audioOnlyMode = false): ICapabilityCheckRepo
 
 /**
  * 异步检查 WebCodecs 详细编解码器支持
+ * 
+ * 与 streaming-video.ts 解码策略一致：
+ * - Android（含 OpenHarmony/ArkWeb）：主路径为 prefer-software 软解码，默认配置兜底
+ * - 其余环境：主路径为默认配置（硬解码）
+ * 逐 codec 探测两种配置的支持度，并按平台主路径判定 SDK 可用性
  */
 async function checkWebCodecsDetailed(): Promise<ICapabilityCheckItem> {
   try {
     const hasVideoDecoder = typeof (window as any).VideoDecoder !== 'undefined';
-    const supported = hasVideoDecoder;
 
-    if (!supported) {
+    if (!hasVideoDecoder) {
       return {
         name: 'webcodecs',
         supported: false,
@@ -202,29 +216,89 @@ async function checkWebCodecsDetailed(): Promise<ICapabilityCheckItem> {
       };
     }
 
+    // 平台判定与 streaming-video.ts 保持一致
+    const userAgent = (navigator.userAgent || '').toLowerCase();
+    const isAndroid = /android/.test(userAgent) || /openharmony|arkweb/.test(userAgent);
+
+    // 探测配置补全尺寸字段：与业务 isConfigSupported(config) 一致（纯 codec 在部分浏览器被拒）
+    const probeW = 2160;
+    const probeH = 1920;
+
     // 探测具体编解码器支持
-    let codecSupport: Record<string, boolean> = {};
+    // 注意：WebCodecs 的 codec 字段是纯编解码器字符串（如 avc1.640032），
+    //       不能用 video/mp4; codecs="..." 的 MIME 形式（会导致 isConfigSupported 抛异常）
+    let codecSupport: Record<string, { default: boolean; software: boolean | null; error?: string }> = {};
     const testCodecs = [
-      'video/mp4; codecs="avc1.42E01E"',  // H.264 Baseline
-      'video/mp4; codecs="avc1.4D001F"',  // H.264 Main
-      'video/mp4; codecs="avc1.64001F"',  // H.264 High
+      'avc1.42E01E',  // H.264 Baseline
+      'avc1.4D001F',  // H.264 Main
+      'avc1.64001F',  // H.264 High
     ];
+
+    // 主路径（平台默认解码配置）与兜底（默认配置）任一支持即判定可用
+    let primarySupported = false;
+    let fallbackSupported = false;
+    // 探测过程是否出现异常（区别于"确实不支持"）：异常时降级 warn，避免误杀可用环境
+    let probeFailed = false;
     for (const codec of testCodecs) {
       try {
-        const result = await (window as any).VideoDecoder.isConfigSupported({
+        // 默认配置（浏览器默认/硬解），业务兜底路径
+        const defaultResult = await (window as any).VideoDecoder.isConfigSupported({
           codec,
+          codedWidth: probeW,
+          codedHeight: probeH,
         });
-        codecSupport[codec] = result.supported;
+        const defaultOk = !!defaultResult?.supported;
+        if (defaultOk) {
+          fallbackSupported = true;
+        }
+
+        // Android 主路径：prefer-software 软解码（与 streaming-video.ts 一致）
+        let softwareOk: boolean | null = null;
+        if (isAndroid) {
+          try {
+            const softwareResult = await (window as any).VideoDecoder.isConfigSupported({
+              codec,
+              codedWidth: probeW,
+              codedHeight: probeH,
+              hardwareAcceleration: 'prefer-software',
+            });
+            softwareOk = !!softwareResult?.supported;
+          } catch {
+            softwareOk = false;
+          }
+          if (softwareOk) {
+            primarySupported = true;
+          }
+        } else if (defaultOk) {
+          primarySupported = true;
+        }
+
+        codecSupport[codec] = { default: defaultOk, software: softwareOk };
       } catch {
-        codecSupport[codec] = false;
+        // isConfigSupported 抛异常：探测方式受限（如浏览器实现差异），非"确实不支持"
+        probeFailed = true;
+        codecSupport[codec] = { default: false, software: null, error: 'probe-failed' };
       }
     }
 
+    const supported = primarySupported || fallbackSupported;
+    // 探测异常且无任何配置支持：降级 warn（运行时业务用真实 config 的 isConfigSupported 为准）
+    const severity = probeFailed && !supported ? 'warn' : 'fatal';
     return {
       name: 'webcodecs',
-      supported: true,
-      severity: 'fatal',
-      detail: { hasVideoDecoder, codecSupport },
+      supported,
+      severity,
+      reason: supported
+        ? undefined
+        : severity === 'warn'
+          ? 'WebCodecs 探测异常（运行时将以实际视频配置二次确认）'
+          : '浏览器不支持 H.264 解码（默认/软解配置均不可用）',
+      detail: {
+        hasVideoDecoder,
+        isAndroid,
+        hardwareAcceleration: isAndroid ? 'prefer-software' : 'default',
+        codecSupport,
+      },
     };
   } catch (e) {
     return {