@xmov/avatar 2.0.1 → 2.1.0

package/dist/modules/ResourceManager.d.ts

@@ -3,7 +3,7 @@ import XmovAvatar from "../index";
 /**
  * 资源处理模块，加载并存储资源
  */
-type TOptions = Pick<IAvatarOptions, "appId" | "appSecret" | "gatewayServer" | 'cacheServer' | "sdkInstance" | "config" | "headers" | "gateway_type" | "tag" | "asr_id" | "llm_id" | "session_speak_req_id"> & {
+type TOptions = Pick<IAvatarOptions, "appId" | "appSecret" | "gatewayServer" | 'cacheServer' | "sdkInstance" | "config" | "headers" | "gateway_type" | "tag" | "asr_id" | "llm_id" | "session_speak_req_id" | "audioOnlyMode"> & {
     sessionRequestData?: Record<string, unknown>;
     onNetworkInfo(quality: INetworkInfo): void;
     onStartSessionWarning?: (message: Object) => void;
@@ -169,6 +169,7 @@ export default class ResourceManager {
     private isProcessingVideo;
     private cacheServer?;
     private startSessionTimer;
+    private audioOnlyMode;
     private downloadingVideos;
     first_load: boolean;
     constructor(options: TOptions);

package/dist/utils/request.d.ts

@@ -14,6 +14,7 @@ export declare function XMLRequest(options: {
     cache?: {
         enable: boolean;
     };
+    timeout?: number;
     onProgress: (progress: number, e: ProgressEvent) => void;
 }): Promise<[boolean, ArrayBuffer | string]>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmov/avatar",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "魔珐数字人 JS-SDK",
   "type": "module",
   "source": "src/index.ts",
@@ -26,15 +26,20 @@
     "src/"
   ],
   "scripts": {
-    "build": "microbundle --workers --define ENV=production,VERSION=$npm_package_version --external none --tsconfig tsconfig.json && pnpm run build:agent && node upload-sdk.js build",
+    "build": "pnpm run build:core && pnpm run build:agent && pnpm run build:e2e:cdn && pnpm run test:e2e:cdn && node upload-sdk.js build",
+    "build:core": "microbundle --workers --define ENV=production,VERSION=$npm_package_version --external none --tsconfig tsconfig.json",
     "build:agent": "microbundle --entry src/agent/index.ts --output dist/agent --format modern,esm,cjs,umd --external @xmov/avatar --alias ../index=@xmov/avatar --globals @xmov/avatar=XmovAvatar --name XingyunAvatarAgentModule --tsconfig tsconfig.agent.json && node scripts/build-agent-entry.mjs",
-    "sdk": "microbundle watch --workers --define ENV=development,VERSION=$npm_package_version --external none --tsconfig tsconfig.json",
+    "build:e2e:cdn": "microbundle --entry src/agent/cdn-entry.ts --output cdn-dist/xmovAvatar_e2e.js --format iife --external none --workers --define ENV=production,VERSION=$npm_package_version --tsconfig tsconfig.agent.json --no-pkg-main --no-sourcemap",
+    "sdk": "pnpm --filter @xmov/avatar run --parallel --no-bail \"/^sdk:.+$/\"",
+    "sdk:core": "microbundle watch --workers --define ENV=development,VERSION=$npm_package_version --external none --tsconfig tsconfig.json",
+    "sdk:agent": "node scripts/build-agent-entry.mjs && microbundle watch --entry src/agent/index.ts --output dist/agent --format modern,esm,cjs,umd --external @xmov/avatar --alias ../index=@xmov/avatar --globals @xmov/avatar=XmovAvatar --name XingyunAvatarAgentModule --tsconfig tsconfig.agent.json",
     "app": "cd app/ && npm run dev",
     "app:lan": "pnpm --dir app dev:lan",
     "test:agent": "node scripts/run-agent-tests.mjs",
     "test:agent:exports": "pnpm run build:agent && node scripts/test-agent-package-exports.mjs",
     "test:agent:browser": "playwright test",
-    "lite": "node replaceString.js && npm run build && node upload-sdk.js lite",
+    "test:e2e:cdn": "node scripts/test-e2e-cdn-build.mjs",
+    "lite": "node replaceString.js && pnpm run build:core && node upload-sdk.js lite",
     "proto": "pbjs -t static-module -w closure -o src/proto/face_data_pb.js src/proto/face_data.proto",
     "commitlint": "commitlint --edit",
     "prepare": "husky"

package/src/agent/cdn-entry.ts

@@ -0,0 +1,15 @@
+import XingyunAvatarAgent, {
+  AgentE2EClient,
+  DEFAULT_AGENT_AUDIO,
+  MicrophoneController,
+} from "./index";
+
+Object.assign(XingyunAvatarAgent, {
+  AgentE2EClient,
+  DEFAULT_AGENT_AUDIO,
+  MicrophoneController,
+});
+
+(globalThis as typeof globalThis & {
+  XingyunAvatarAgent: typeof XingyunAvatarAgent;
+}).XingyunAvatarAgent = XingyunAvatarAgent;

package/src/baseRender/AudioRenderer.ts

@@ -225,19 +225,25 @@ export default class AudioRender {
   pause() {
     this.isPlaying = false;
     this.options.dataCacheQueue._clearAudio(this.speech_id);
+    this.lastFrameIndex = -1;
     this.firstFrameIndex = -1;
+    this.cacheFirstFrameIndex = -1;
+    this.cacheAudioData = [];
+    this.mseCacheAudioData = [];
+    this.oldSpeechId = -1;
     // 停止 PCM 播放
     this.audio?.stop();
-    
+
     // 停止 WebM 播放
     this.mseAudioPlayer?.stop(this.addNewAudioSegment.bind(this));
     this.speech_id = -1;
   }
 
   stop(speech_id: number) {
-    // 如果当前需要结束的是旧的语音ID，直接返回
-    if(this.oldSpeechId >= speech_id) return;
-    
+    // speech_id === -1 表示强制清理（用于 pauseRender / destroy / 断网重连场景），不受 oldSpeechId 限制
+    // 否则如果 oldSpeechId >= speech_id 直接返回，避免重复处理
+    if (speech_id !== -1 && this.oldSpeechId >= speech_id) return;
+
     this.isPlaying = false;
     this.options.dataCacheQueue._clearAudio(speech_id);
     this.firstFrameIndex = -1;
@@ -255,7 +261,12 @@ export default class AudioRender {
     }
     this.oldSpeechId = speech_id;
     this.speech_id = -1;
-    if (this.cacheAudioData.length > 0) {
+    if (speech_id === -1) {
+      // 强制清理：清空所有缓存数据，不推入音频流（用于 pauseRender / destroy / 断网重连）
+      this.cacheFirstFrameIndex = -1;
+      this.cacheAudioData = [];
+      this.mseCacheAudioData = [];
+    } else if (this.cacheAudioData.length > 0) {
       this.firstFrameIndex = this.cacheFirstFrameIndex;
       this.cacheFirstFrameIndex = -1;
       // 新的缓存下来的数据，推入音频流

package/src/baseRender/AvatarRenderer.ts

@@ -19,16 +19,11 @@ type Option = {
   resourceManager: ResourceManager;
   saveAndDownload: SaveAndDownload;
   forceSyncDecoder: () => void;
-  reportMessage: (message: {
-    code: EErrorCode;
-    message: string;
-    e?: object;
-  }) => void;
+  reportMessage: (message: { code: EErrorCode; message: string; e?: object }) => void;
   onDownloadProgress: (progress: number) => void;
   onStateChange: (state: string) => void;
   onRenderChange: (state: RenderState) => void;
   sendVideoInfo: (info: { name: string; body_id: number; id: number }) => void;
-  onError: (error: any) => void;
   sendSdkPoint: (point: string, data: any) => void;
 };
 export default class AvatarRender {
@@ -989,13 +984,13 @@ export default class AvatarRender {
     } else {
       if(this.lastRealFaceFrame === -1) {
         faceFrame = curRealFaceData;
-        // this.options.onError({
+        // this.options.reportMessage({
         //   code: EErrorCode.RENDER_FACE_ERROR,
         //   message: `第${frameIndex}帧 实时面部数据为空,原始数据渲染`,
         //   e: JSON.stringify({ bodyFrame, faceFrame }),
         // });
       } else {
-        // this.options.onError({
+        // this.options.reportMessage({
         //   code: EErrorCode.RENDER_FACE_ERROR,
         //   message: `第${frameIndex}帧 实时面部数据为空，插值渲染`,
         //   e: JSON.stringify({ bodyFrame, faceFrame }),
@@ -1036,30 +1031,26 @@ export default class AvatarRender {
       // 判断bodyFrame和faceFrame是否为空
       if (!bodyFrame) {
         this.allLostFrameCount++;
-        this.options.onError({
+        this.options.reportMessage({
           code: EErrorCode.RENDER_BODY_ERROR,
           message: `Error:  第${frameIndex}帧 bodyFrame为空`,
-          e: JSON.stringify({ bodyFrame, faceFrame }),
+          e: { bodyFrame, faceFrame },
         });
       } else if (!faceFrame) {
         this.allLostFaceFrameCount++;
-        this.options.onError({
+        this.options.reportMessage({
           code: EErrorCode.RENDER_FACE_ERROR,
           message: `Error: 第${frameIndex}帧 faceFrame为空`,
-          e: JSON.stringify({ bodyFrame, faceFrame }),
+          e: { bodyFrame, faceFrame },
         });
       }
       if(this.allLostFrameCount === this.maxLostFrameCount) {
         this.options.reportMessage({
           code: EErrorCode.RENDER_DATA_MISSING,
-          message: `连续${this.maxLostFrameCount}帧 身体渲染数据缺失.`,
+          message: `连续${this.maxLostFrameCount}帧 身体渲染数据缺失`,
+          e: { bodyFrame, faceFrame },
         });
         // 丢失过多帧,达到最大允许丢失帧数后,触发解码器对齐到最新的一帧
-         this.options.onError({
-          code: EErrorCode.RENDER_DATA_MISSING,
-          message: `Error: 连续${this.maxLostFrameCount}帧 身体渲染数据缺失`,
-          e: JSON.stringify({ bodyFrame, faceFrame }),
-        });
         this.forceSyncDecoder();
         this.allLostFrameCount = 0;
       }
@@ -1180,10 +1171,10 @@ export default class AvatarRender {
           rendered = true;
         } catch (error) {
           (window as any).avatarSDKLogger.error(this.TAG, "渲染帧失败:", error);
-          this.options.onError({
+          this.options.reportMessage({
             code: EErrorCode.WebGL_RENDER_ERROR,
             message: `Error: 第${frameIndex}帧 webgl渲染异常`,
-            e: JSON.stringify({ bodyFrame, faceFrame, error }),
+            e: { bodyFrame, faceFrame, error },
           });
         } finally {
           // 渲染完成后再关闭VideoFrame

package/src/baseRender/MSEAudioPlayer.ts

@@ -184,14 +184,25 @@ export default class MediaSourceAudioPlayer {
    * 获取缓冲范围
    */
   private getBufferedRanges(): string {
-    if (this.sourceBuffer && this.sourceBuffer.buffered.length > 0) {
-      const ranges: string[] = [];
-      for (let i = 0; i < this.sourceBuffer.buffered.length; i++) {
-        const start = this.sourceBuffer.buffered.start(i).toFixed(2);
-        const end = this.sourceBuffer.buffered.end(i).toFixed(2);
-        ranges.push(`[${start}-${end}]`);
+    try {
+      // stop/destroy 流程中浏览器会先移除 SourceBuffer 再置空引用，
+      // 此时访问 .buffered 会抛 InvalidStateError，需要 readyState 校验 + 兜底
+      if (
+        this.sourceBuffer &&
+        this.mediaSource?.readyState === "open" &&
+        this.sourceBuffer.buffered.length > 0
+      ) {
+        const ranges: string[] = [];
+        for (let i = 0; i < this.sourceBuffer.buffered.length; i++) {
+          const start = this.sourceBuffer.buffered.start(i).toFixed(2);
+          const end = this.sourceBuffer.buffered.end(i).toFixed(2);
+          ranges.push(`[${start}-${end}]`);
+        }
+        return ranges.join(", ");
       }
-      return ranges.join(", ");
+    } catch (e) {
+      // SourceBuffer 已被移除（stop/destroy 竞态），视为无缓冲数据
+      return "-";
     }
     return "-";
   }

package/src/control/RenderScheduler.ts

@@ -158,9 +158,6 @@ export default class RenderScheduler {
         this.renderState = state;
       },
       sendVideoInfo: config.sendVideoInfo,
-      onError: (error: any) => {
-        this.sdk.onMessage(error);
-      },
     });
     this.uiRenderer = new UIRenderer({
       sdk: this.sdk,
@@ -341,9 +338,10 @@ export default class RenderScheduler {
           } else {
             nowFaceData.push(faceData[i]);
           }
-          nowFaceData.length && this.dataCacheQueue._updateFacial(nowFaceData);
-          realFaceData.length && this.dataCacheQueue._updateRealFacial(realFaceData);
         }
+        // 分类完成后一次性入队，避免循环内对累加数组重复 push 导致队列数据重复
+        nowFaceData.length && this.dataCacheQueue._updateFacial(nowFaceData);
+        realFaceData.length && this.dataCacheQueue._updateRealFacial(realFaceData);
         break;
       case EFrameDataType.AUDIO:
         const audioData = data as IRawAudioFrameData[];
@@ -411,6 +409,11 @@ export default class RenderScheduler {
             clearTimeout(this._speedResetTimer);
         }
 
+        // 播放加速大于4，直接丢弃
+        if (playbackSpeed > 4) {
+          return;
+        }
+
         // 8. 应用速度
         this.audioRenderer.setSpeed(playbackSpeed);
 
@@ -490,7 +493,34 @@ export default class RenderScheduler {
             code: EErrorCode.EVENT_TRIGGERED,
             message: 'WARNING: 有新的speak_start事件，但是上一轮仍未结束，触发兜底结束',
           });
-          this.interrupt('new_speak_start');
+          const currentSpeakStart = d.flatMap(item => item.e ?? []).find(ev => ev.type === 'speak_start');
+          const newSpeakId = currentSpeakStart?.speech_id ?? 0;
+          const playingSpeechId = this.audioRenderer.speech_id;
+          // 仅当正在播放的确实是上一轮（sid 小于新一轮）时才打断旧轮次。
+          // 若事件晚于音频到达（playingSpeechId 已是新一轮 sid），此时播放的就是新一轮，
+          // 不能用 interrupt()（其目标取 audioRenderer.speech_id），否则会误清新一轮的音频队列、
+          // 字幕事件，并因 lastSpeechId/oldSpeechId 更新导致后续音视频帧全部被丢弃，
+          // 表现为"有口型、无字幕、无音频"。
+          if (playingSpeechId !== -1 && playingSpeechId < newSpeakId) {
+            this.interrupt('new_speak_start', playingSpeechId);
+            // stop() 内部有 oldSpeechId >= speech_id 的防重入守卫：当 speech_id 停留在
+            // 异常残留值（如初始值 0，长会话中 isPlaying 卡死为 true）时 stop 会被拦截，
+            // isPlaying/speech_id 无法复位，导致新一轮音频在 _updateAudio 中永远走缓存分支
+            // 不播放（日志表现：缓存数据长度持续增长且无"开始播放"）。
+            // 这里检测到 stop 未生效（speech_id 未复位为 -1）时，用 pause() 强制复位，
+            // pause 会 flush 已缓存音频并把 speech_id/oldSpeechId 重置，新一轮可正常起播。
+            if (this.audioRenderer.speech_id !== -1) {
+              this.audioRenderer.pause();
+            }
+          }
+          // 新 speak_start 已到来，立即复位 interrupt 并更新轮次状态，
+          // 避免依赖 UIRenderer 在 sf 帧处理事件时（sf==当前帧且事件在 compose 后被处理）被漏处理，
+          // 导致新轮次实际说话期间仍被强制渲染为闭嘴表情
+          if (currentSpeakStart) {
+            this.currentSpeechId = currentSpeakStart.speech_id ?? 0;
+            this.avatarRenderer.setInterrupt(false);
+            this.uiRenderer.lastSpeechId = currentSpeakStart.speech_id ?? 0;
+          }
         }
 
         // 2. 处理过期speak_start
@@ -810,6 +840,21 @@ export default class RenderScheduler {
     }])
   }
 
+  /**
+   * 重连成功恢复（含窗口内 socket.io 自动重连恢复、窗口外重开房间）：
+   * 数据缓存在断网进入离线时已清空（_offlineMode/_offlineRun），此处仅恢复播放状态：
+   * - 标记帧号对齐：首个 BODY/AUDIO 数据到达时按 sf 重设帧时钟
+   * - 恢复音频播放
+   * - 解码器退出离线模式（重置 _offlineLastFrame、清空离线队列）
+   * 避免离线 idle 播放推进的帧号领先服务端续推数据导致人物卡死、音画不同步
+   */
+  markReconnectRecover() {
+    // 恢复音频播放
+    this.audioRenderer.resume();
+    // 解码器退出离线模式（重置 _offlineLastFrame、清空离线队列）
+    this.decoder._reload();
+  }
+
   _offlineMode() {
     this.dataCacheQueue._clearEvent();
     const currentFrame = this.getCurrentFrameIndex() ?? 0;
@@ -830,6 +875,14 @@ export default class RenderScheduler {
     if (frame) {
       this.decoder._offLineMode(this.resourceManager._getOfflineIdle(), frame);
     }
+    // 重置所有 speechId 相关状态，避免联网后新语音被过滤
+    // - lastSpeechId: 用于过滤旧 sid 的音频数据（L444）
+    // - currentSpeechId: 用于 speak_end 时判断是否 setInterrupt
+    // - uiRenderer.lastSpeechId: UIRenderer 会过滤 sid < lastSpeechId 的事件（含 speak_start）
+    //   若不重置，联网后新语音的 speak_start 会被过滤，导致字幕正常但无音频
+    this.lastSpeechId = -1;
+    this.currentSpeechId = -1;
+    this.uiRenderer.lastSpeechId = -1;
   }
   _offlineRun() {
     this.decoder._offlineRun()
@@ -844,6 +897,16 @@ export default class RenderScheduler {
     this.audioRenderer.resume();
   }
 
+  /**
+   * app 切后台时暂停音频并清空对齐状态（复用断网离线时的 pause()）
+   * 不能保留缓存续播：Android 后台视频帧号持续递增而音频停留在暂停位置，
+   * 恢复后音画基准脱节；且后台期间可能下发新 speak 数据，旧缓存与新 sf 冲突。
+   * 恢复后依赖新下发音频的 sf 作为 firstFrameIndex 重新对齐
+   */
+  pauseForBackground() {
+    this.audioRenderer.pause();
+  }
+
   /**
    * 设置数字人canvas的显隐状态
    * @param visible 是否可见
@@ -859,10 +922,13 @@ export default class RenderScheduler {
     this.avatarRenderer.setWalkConfig(walkConfig);
   }
 
-  interrupt(type?: string): number{
+  // targetSpeechId: 显式指定要打断的轮次 sid。缺省时取 audioRenderer.speech_id（当前播放轮次）。
+  // 当事件晚于音频到达时，audioRenderer.speech_id 可能已经切换到新一轮，此时必须显式传旧 sid，
+  // 避免误清新一轮的音频与字幕。
+  interrupt(type?: string, targetSpeechId?: number): number{
     const start = Date.now();
     // 插入中断字幕和语音结束事件
-    const speech_id = this.audioRenderer.speech_id;
+    const speech_id = targetSpeechId ?? this.audioRenderer.speech_id;
     if(type === "in_offline_mode") {
       this.lastSpeechId = -1;
     } else {

package/src/control/ttsa.ts

@@ -55,6 +55,7 @@ interface ITtsaOptions {
   enterOfflineMode: () => void;
   reStartSDK: () => void;
   reconnect_client_timeout: number;
+  reconnect_timeout: number;
   sendVoiceEnd: () => void;
   getCurrentFrameIndex: () => number;
 }
@@ -77,7 +78,9 @@ export default class Ttsa {
   private enterOfflineMode: () => void;
   private reStartSDK: () => void;
   private reconnect_client_timeout: number;
-  private reconnectTimer = -1;
+  private reconnect_timeout: number;
+  private reconnectTimer = -1;          // 重开房间定时器（reconnect_client_timeout 后 stopSession + reStartSDK）
+  private socketReconnectTimer = -1;    // 停止 socket.io 自动重连定时器（reconnect_timeout 后旧房间已失效）
   private wsConnectTimer = 0;
   private enterOfflineFlag = false;
   private sendVoiceEnd: () => void;
@@ -94,13 +97,26 @@ export default class Ttsa {
   private readonly HEARTBEAT_INTERVAL = 2000;
 
   /**
-   * 清除WebSocket重连定时器
+   * 清除WebSocket重连定时器（含停止 socket.io 自动重连的定时器）
    */
   public clearReconnectTimer(): void {
     if (this.reconnectTimer !== -1) {
       clearTimeout(this.reconnectTimer);
       this.reconnectTimer = -1;
     }
+    // 一并清理停止 socket.io 自动重连的定时器：网络恢复后交由 socket.io 自行重连，
+    // 不再强制断开（下次 disconnect 会重新按窗口设置）
+    this.clearSocketReconnectTimer();
+  }
+
+  /**
+   * 清除停止 socket.io 自动重连的定时器
+   */
+  private clearSocketReconnectTimer(): void {
+    if (this.socketReconnectTimer !== -1) {
+      clearTimeout(this.socketReconnectTimer);
+      this.socketReconnectTimer = -1;
+    }
   }
 
   /**
@@ -146,6 +162,7 @@ export default class Ttsa {
     this.enterOfflineMode = options.enterOfflineMode;
     this.reStartSDK = options.reStartSDK;
     this.reconnect_client_timeout = options.reconnect_client_timeout;
+    this.reconnect_timeout = options.reconnect_timeout;
     this.sendVoiceEnd = options.sendVoiceEnd;
     this.getCurrentFrameIndex = options.getCurrentFrameIndex;
 
@@ -154,6 +171,9 @@ export default class Ttsa {
         token: this.token,
       },
       transports: ['websocket'],
+      // 自动重连不限制次数：在 reconnect_timeout（服务端断开旧房间的窗口）内持续尝试，
+      // 失效房间必然重连失败；超过窗口由 disconnect 处理器中的停止定时器断开，
+      // 超过 reconnect_client_timeout 由重开房间定时器兜底（stopSession + reStartSDK）
       reconnection: true,
       reconnectionAttempts: Infinity,
       reconnectionDelay: 1000,
@@ -167,17 +187,21 @@ export default class Ttsa {
       this.initWsTimeoutTimer();
       // 启动客户端心跳
       this.startHeartbeat();
+      // 重置离线处理标志：重连成功后允许下次断网正常进入离线/重连流程
+      this.enterOfflineFlag = false;
       (window as any).performanceTracker.markEnd(performanceConstant.ttsa_connect);
       const payload = {
         room: this.room,
         client_type: "web",
         invisible_mode: this.sdk.getPendingInvisibleMode(),
       };
-      // TODO: 临时处理，待后端修复
-      if(this.sdk.getStatus()=== AvatarStatus.offline) {
-        this.sdk.onStatusChange(AvatarStatus.online);
-      }
       this.send("enter_room", payload);
+      // 窗口内自动重连恢复：服务端可能不重发 first_start_timestamp，
+      // 若仅依赖 reloadSuccess 补发 online/恢复播放，状态会卡在离线导致重连后卡死。
+      // 因此重连成功即恢复（仅初始化完成且此前已离线时；初次启动 status 为 -1 不受影响）
+      if (this.sdk.getStatus() === AvatarStatus.offline && this.sdk.getIsInitialized()) {
+        this.reloadSuccess();
+      }
     });
     ws.on("first_start_timestamp", (e: any) => {
       (window as any).avatarSDKLogger.log(this.TAG, "first_start_timestamp", e);
@@ -339,11 +363,23 @@ export default class Ttsa {
         // 无网断开则进入离线模式
         this.enterOfflineMode();
       }
-      // 发起定时器，getReconnectClientTimeout时间内重连socket，超过时间则发起reStartSession
-      // 只有在网络断开时才设置重连定时器，网络恢复时由NetworkMonitor处理
-      if (!navigator.onLine) {
-        // 清除可能存在的旧定时器
-        this.clearReconnectTimer();
+      // 重连窗口策略（不再依赖 navigator.onLine，socket 断开即启动）：
+      // ① socketReconnectTimer（reconnect_timeout）：窗口内 socket.io 自动重连；
+      //    服务端会在 reconnect_timeout 后断开旧房间，因此窗口结束即停止无谓的自动重连
+      // ② reconnectTimer（reconnect_client_timeout）：仍未能重连则停止旧连接并重开房间
+      // 均仅首次设置，避免 socket.io 重连失败反复触发 disconnect 重置定时器导致永不执行；
+      // 重连成功时 connect 处理器、网络恢复时 NetworkMonitor -> clearReconnectTimer 都会取消
+      if (this.socketReconnectTimer === -1 && this.reconnect_timeout > 0) {
+        this.socketReconnectTimer = window.setTimeout(() => {
+          try {
+            ws.disconnect();
+          } catch (error) {
+            (window as any).avatarSDKLogger.warn(this.TAG, "disconnect error", error);
+          }
+          this.socketReconnectTimer = -1;
+        }, this.reconnect_timeout * 1000);
+      }
+      if (this.reconnectTimer === -1) {
         this.reconnectTimer = window.setTimeout(async () => {
           try {
             ws.disconnect();