@xmov/avatar 2.4.0-beta.2 → 2.4.0-beta.4

package/dist/modules/ResourceManager.d.ts

@@ -237,7 +237,9 @@ export default class ResourceManager {
     load(onDownloadProgress?: TDownloadProgress): Promise<ISessionResponse | null>;
     startSession(): Promise<any>;
     _startSession(): Promise<any> | null;
-    stopSession(stop_reason: string): Promise<any>;
+    stopSession(stop_reason: string, options?: {
+        keepalive?: boolean;
+    }): Promise<any>;
     /**
      * 加载表情数据
      */

package/dist/utils/request.d.ts

@@ -3,6 +3,7 @@ interface RequestOptions {
     method?: HttpMethod;
     data?: Record<string, any>;
     headers?: Record<string, string>;
+    keepalive?: boolean;
 }
 export default function request(url: string, options?: RequestOptions): Promise<Response>;
 /**

package/package.json

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

package/src/index.ts

@@ -43,6 +43,7 @@ export default class XmovAvatar {
 
   // 使用 ! 操作符告诉 TypeScript 这些属性会在构造函数中被初始化
   private resourceManager!: ResourceManager;
+  private beforeUnloadStopSessionPromise: ReturnType<ResourceManager["stopSession"]> | null = null;
   private renderScheduler!: RenderScheduler;
   private networkMonitor: NetworkMonitor | null = null;
   private ttsa: Ttsa | null = null;
@@ -642,6 +643,9 @@ export default class XmovAvatar {
       this.pendingInvisibleMode = true;
     }
 
+    // Session 请求和资源下载期间也需要处理页面刷新。
+    window.addEventListener('beforeunload', this.handleBeforeUnload);
+
     // 加载资源（sdk.resource_load：资源包下载/解析耗时）
     (window as any).performanceTracker.markStart(performanceConstant.load_resource);
     (window as any).performanceTracker.markStart(performanceConstant.first_avatar_render);
@@ -674,7 +678,6 @@ export default class XmovAvatar {
     // 设置上报使用ttsa
     (window as any).performanceTracker.setReportFunc(this.ttsa);
 
-    window.addEventListener('beforeunload', this.handleBeforeUnload);
     document.addEventListener('visibilitychange', this.boundVisibilityChange);
     initSpan?.end();
     return sessionInfo;
@@ -1315,7 +1318,11 @@ export default class XmovAvatar {
   }
 
   private handleBeforeUnload = () => {
-    this.destroy("beforeunload");
+    if (!this._isClientMode && (this.resourceManager?.session_id || this.resourceManager?.session_request_id)) {
+      // Page dismissal cannot wait for E2E and TTSA shutdown before starting DELETE.
+      this.beforeUnloadStopSessionPromise ??= this.resourceManager.stopSession("beforeunload", { keepalive: true });
+    }
+    void this.destroy("beforeunload");
   };
 
   public isDestroyed() {
@@ -1459,7 +1466,7 @@ export default class XmovAvatar {
     this.ttsa?.sendSdkPoint('close_session', {
       reason: stop_reason,
     });
-    const res = await this.resourceManager.stopSession(stop_reason);
+    const res = await (this.beforeUnloadStopSessionPromise ?? this.resourceManager.stopSession(stop_reason));
     await this.destroyClient();
     if(res) {
       this.onStatusChange(AvatarStatus.close);
@@ -1483,7 +1490,7 @@ export default class XmovAvatar {
     } finally {
       try {
         if (!this._isClientMode) {
-          await this.resourceManager.stopSession(stopReason);
+          await (this.beforeUnloadStopSessionPromise ?? this.resourceManager.stopSession(stopReason));
         }
       } finally {
         await this.destroyClient();

package/src/modules/ResourceManager.ts

@@ -406,7 +406,7 @@ export default class ResourceManager {
       });
   }
 
-  async stopSession(stop_reason: string) {
+  async stopSession(stop_reason: string, options: { keepalive?: boolean } = {}) {
     try {
       const url = `${this.options.gatewayServer}`;
       // session_id 尚未返回时（如 init 未完成就 destroy），只要有 request_id 仍发请求，
@@ -424,7 +424,7 @@ export default class ResourceManager {
         data.request_id = this.session_request_id;
       }
       const { headers, data: signedData } = headersNeedSign(this.options.appId, this.options.appSecret, "DELETE", url, data);
-      const response = await request(url, { method: "DELETE", data: signedData, headers: { ...headers, ...this.options.headers } });
+      const response = await request(url, { method: "DELETE", data: signedData, headers: { ...headers, ...this.options.headers }, keepalive: options.keepalive });
       return await response.json();
     } catch (error) {
       this.sdk.onMessage({

package/src/utils/request.ts

@@ -4,6 +4,7 @@ interface RequestOptions {
   method?: HttpMethod
   data?: Record<string, any>
   headers?: Record<string, string>
+  keepalive?: boolean
 }
 
 interface ErrorResponse {
@@ -21,6 +22,7 @@ export default async function request(
 
   const config: RequestInit = {
     method,
+    keepalive: options.keepalive,
     // headers,
     headers: {
       'Content-Type': 'application/json',
@@ -104,4 +106,4 @@ export function XMLRequest(options: {
     };
     xhr.send();
   });
-}
+}