@xmov/avatar 2.4.0-alpha.4 → 2.4.0-alpha.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmov/avatar",
-  "version": "2.4.0-alpha.4",
+  "version": "2.4.0-alpha.5",
   "description": "魔珐数字人 JS-SDK",
   "type": "module",
   "source": "src/index.ts",

package/src/index.ts

@@ -133,6 +133,9 @@ export default class XmovAvatar {
     (window as any).avatarSDKLogger.setEnabled(options.enableLogger);
     this.options = options;
     this._env = options.env || "production"
+    // 提前创建 Sentry：无网络 / 容器不存在 / 能力检查失败等错误都要经 onMessage 上报，
+    // 而 onMessage 的上报条件是 sentryReporter 已存在，晚建会让这些早期错误全部丢失
+    this.initSentryReporter();
     this.enableClientInterrupt = options.enableClientInterrupt || false;
     this.boundVisibilityChange = this.visibilitychange.bind(this);
 
@@ -144,7 +147,14 @@ export default class XmovAvatar {
     }
 
     // 完整渲染模式（原有逻辑）
-    this.initializeSDK(options);
+    // initializeSDK 是 fire-and-forget：内部同步抛错（如 layout.scale 校验）与未捕获的异步失败
+    // 都不会走 onMessage，这里兜底上报，避免业务既拿不到错误回调、监控也收不到
+    void this.initializeSDK(options).catch((e) => {
+      this.reportInitializationFailure(
+        `SDK 初始化失败: ${e?.message || e}`,
+        e
+      );
+    });
     this.networkMonitor = new NetworkMonitor({
       offlineCallback: (message) => {
         this.onMessage({
@@ -199,6 +209,34 @@ export default class XmovAvatar {
     })
   }
 
+  /**
+   * 创建 Sentry 错误上报实例（编译时常量 ENABLE_SENTRY + 运行时 sentry.enabled 双重控制）。
+   * 放在构造函数内完成：onMessage 的早期分支（无网络 / 容器不存在 / 能力检查失败）都发生在其后。
+   */
+  private initSentryReporter(): void {
+    if (!ENABLE_SENTRY || !this.options.sentry?.enabled) return;
+    try {
+      this.sentryReporter = new SentryReporter(SENTRY_DSN, {
+        tracesSampleRate: this.options.sentry?.tracesSampleRate,
+      });
+      this.sentryReporter.setTag('app_id', this.options.appId || '');
+      this.sentryReporter.setTag('env', this._env);
+    } catch (e) {
+      (window as any).avatarSDKLogger.warn(this.TAG, 'Sentry 初始化失败', e);
+    }
+  }
+
+  /**
+   * 释放 Sentry 客户端（内部会 flush 未发送的事件）。
+   * 用于「实例确定不可用」的提前退出路径，避免业务反复重试创建时残留多个 client。
+   */
+  private disposeSentryReporter(): void {
+    if (!this.sentryReporter) return;
+    const reporter = this.sentryReporter;
+    this.sentryReporter = null;
+    void reporter.destroy().catch(() => {});
+  }
+
   public getStatus() {
     return this.status
   }
@@ -226,6 +264,8 @@ export default class XmovAvatar {
         code: EErrorCode.NETWORK_BREAK,
         message: '没有网络，请联网后重试',
       });
+      // 无网络直接退出，实例不会进入可用状态，释放 Sentry（内部会 flush 刚上报的事件）
+      this.disposeSentryReporter();
       return
     }
     const self = this;
@@ -247,6 +287,8 @@ export default class XmovAvatar {
           code: EErrorCode.CONTAINER_NOT_FOUND,
           message: `containerId: ${containerId} 不存在`,
         })
+        // 容器不存在，实例不会进入可用状态，释放 Sentry（内部会 flush 刚上报的事件）
+        this.disposeSentryReporter();
         return;
       }
       this.el = el;
@@ -416,7 +458,10 @@ export default class XmovAvatar {
     } else {
       const el = document.querySelector(containerId) as HTMLElement;
       if (!el) {
-        this.options.onMessage?.({ code: EErrorCode.CONTAINER_NOT_FOUND, message: `containerId: ${containerId} 不存在` } as any);
+        // 走 onMessage 统一出口（而非直接调 options.onMessage），否则该错误不会进 Sentry
+        this.onMessage({ code: EErrorCode.CONTAINER_NOT_FOUND, message: `containerId: ${containerId} 不存在` });
+        // 容器不存在，实例不会进入可用状态，释放 Sentry（内部会 flush 刚上报的事件）
+        this.disposeSentryReporter();
         return;
       }
       this.el = el;
@@ -574,20 +619,8 @@ export default class XmovAvatar {
       return;
     }
 
-    // 初始化 Sentry 错误监控（编译时常量 + 运行时配置双重控制）
-    // 编译时 ENABLE_SENTRY 决定代码是否打包，运行时 sentry.enabled 决定是否启用
-    // 提前到资源加载之前创建，使 init / resource_load span 可覆盖整个初始化过程
-    if (ENABLE_SENTRY && this.options.sentry?.enabled) {
-      try {
-        this.sentryReporter = new SentryReporter(SENTRY_DSN, {
-          tracesSampleRate: this.options.sentry?.tracesSampleRate,
-        });
-        this.sentryReporter.setTag('app_id', this.options.appId || '');
-        this.sentryReporter.setTag('env', this._env);
-      } catch (e) {
-        (window as any).avatarSDKLogger.warn(this.TAG, 'Sentry 初始化失败', e);
-      }
-    }
+    // Sentry 实例已在构造函数中提前创建（见 initSentryReporter），
+    // 这样无网络 / 容器不存在 / 能力检查失败等更早的错误也能上报
     // sdk.init：初始化总耗时（含资源加载、连接就绪）
     const initSpan = this.sentryReporter?.startInactiveSpan('sdk.init', { op: 'init' });
     // sdk.first_frame：从初始化到首个 body 帧到达（handleMessage 首次 BODY 帧时结束）
@@ -1408,13 +1441,8 @@ export default class XmovAvatar {
     window.removeEventListener("beforeunload", this.handleBeforeUnload);
     document.removeEventListener("visibilitychange", this.boundVisibilityChange);
 
-    // 清理 Sentry 客户端
-    if (ENABLE_SENTRY && this.sentryReporter) {
-      try {
-        this.sentryReporter.destroy();
-      } catch {}
-      this.sentryReporter = null;
-    }
+    // 清理 Sentry 客户端（内部会 flush 未发送的事件）
+    this.disposeSentryReporter();
 
     (window as any).avatarSDKLogger.log(this.TAG, "SDK 已销毁");
   }