@xmov/avatar 2.4.0-beta.1 → 2.4.0-beta.3

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.1",
+  "version": "2.4.0-beta.3",
   "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;
@@ -1315,7 +1316,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 +1464,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);
@@ -1472,22 +1477,23 @@ export default class XmovAvatar {
     try {
       if (this._isClientMode) {
         this._apiForwarder?.destroy(stopReason);
-      } else if (!this.ttsa?.hasConnected) {
-        // Initialization can own a session/request before TTSA first connects.
-        // Mark an in-flight connection as quitting before waiting for DELETE.
-        await this.ttsa?.quit(stopReason);
-        await this.resourceManager.stopSession(stopReason);
       } else {
-        this.ttsa.sendSdkPoint('close_session', {
-          reason: stopReason,
-        });
-        await this.ttsa.quit(stopReason);
+        if (this.ttsa?.hasConnected) {
+          this.ttsa.sendSdkPoint('close_session', { reason: stopReason });
+        }
+        await this.ttsa?.quit(stopReason);
       }
     } catch (error) {
       (window as any).avatarSDKLogger.warn(this.TAG, "TTSA client_quit 未确认，继续释放本地资源", error);
     } finally {
-      await this.destroyClient();
-      this.onStatusChange(AvatarStatus.close);
+      try {
+        if (!this._isClientMode) {
+          await (this.beforeUnloadStopSessionPromise ?? this.resourceManager.stopSession(stopReason));
+        }
+      } finally {
+        await this.destroyClient();
+        this.onStatusChange(AvatarStatus.close);
+      }
     }
   }
 

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();
   });
-}
+}