@spatialwalk/avatarkit 1.0.0-beta.75 → 1.0.0-beta.77

package/dist/{StreamingAudioPlayer-8jk86K8D.js → StreamingAudioPlayer-BtOgYxcz.js}

@@ -1,7 +1,7 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-DktjmkwV.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-CTh2onXJ.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {
@@ -40,6 +40,18 @@ class StreamingAudioPlayer {
     // Timestamp of last getCurrentTime log (for throttling)
     // Track start time (absolute time) and duration of each scheduled chunk for accurate current playback time calculation
     __publicField(this, "scheduledChunkInfo", []);
+    // 🚀 Chunk 合并优化：减少 AudioNode 创建数量
+    __publicField(this, "pendingChunks", []);
+    // 待合并的小 chunk
+    __publicField(this, "pendingBytesTotal", 0);
+    // 待合并的总字节数
+    __publicField(this, "isFirstMerge", true);
+    // 是否是首次合并（用于首包缓冲）
+    // 合并阈值：动态计算
+    __publicField(this, "MERGE_THRESHOLD_MS", 500);
+    // 后续合并阈值（500ms）
+    __publicField(this, "FIRST_BUFFER_THRESHOLD_MS", 250);
+    // 首包缓冲阈值（250ms）- 牺牲一点延迟换取流畅播放
     // Volume control
     __publicField(this, "gainNode", null);
     __publicField(this, "volume", 1);
@@ -153,6 +165,37 @@ class StreamingAudioPlayer {
       }
     }
   }
+  /**
+   * 🚀 合并待处理的小 chunks 成一个大 chunk
+   */
+  mergePendingChunks() {
+    if (this.pendingChunks.length === 0) {
+      return new Uint8Array(0);
+    }
+    if (this.pendingChunks.length === 1) {
+      const result = this.pendingChunks[0];
+      this.pendingChunks = [];
+      this.pendingBytesTotal = 0;
+      return result;
+    }
+    const merged = new Uint8Array(this.pendingBytesTotal);
+    let offset = 0;
+    for (const chunk of this.pendingChunks) {
+      merged.set(chunk, offset);
+      offset += chunk.length;
+    }
+    this.pendingChunks = [];
+    this.pendingBytesTotal = 0;
+    return merged;
+  }
+  /**
+   * 计算合并阈值（基于实际采样率）
+   * @param isFirst 是否是首次合并（使用较小的首包缓冲阈值）
+   */
+  getMergeThresholdBytes(isFirst = false) {
+    const thresholdMs = isFirst ? this.FIRST_BUFFER_THRESHOLD_MS : this.MERGE_THRESHOLD_MS;
+    return this.sampleRate * this.channelCount * 2 * (thresholdMs / 1e3);
+  }
   /**
    * Add audio chunk (16-bit PCM)
    */
@@ -166,14 +209,29 @@ class StreamingAudioPlayer {
         logger.errorWithError("[StreamingAudioPlayer] Failed to ensure AudioContext running in addChunk:", err);
       });
     }
-    this.audioChunks.push({ data: pcmData, isLast });
-    this.log(`Added chunk ${this.audioChunks.length}`, {
-      size: pcmData.length,
-      totalChunks: this.audioChunks.length,
-      isLast,
-      isPlaying: this.isPlaying,
-      scheduledChunks: this.scheduledChunks
-    });
+    if (pcmData.length > 0) {
+      this.pendingChunks.push(pcmData);
+      this.pendingBytesTotal += pcmData.length;
+    }
+    const mergeThreshold = this.getMergeThresholdBytes(this.isFirstMerge);
+    const shouldMerge = isLast || this.pendingBytesTotal >= mergeThreshold;
+    if (shouldMerge && this.pendingBytesTotal > 0) {
+      const mergedData = this.mergePendingChunks();
+      this.audioChunks.push({ data: mergedData, isLast });
+      this.isFirstMerge = false;
+      this.log(`Added merged chunk ${this.audioChunks.length}`, {
+        size: mergedData.length,
+        totalChunks: this.audioChunks.length,
+        isLast,
+        isPlaying: this.isPlaying,
+        scheduledChunks: this.scheduledChunks
+      });
+    } else if (isLast && this.pendingBytesTotal === 0) {
+      this.audioChunks.push({ data: new Uint8Array(0), isLast: true });
+    } else {
+      this.log(`Accumulating chunk, pending: ${this.pendingBytesTotal} bytes (threshold: ${mergeThreshold}, isFirstMerge: ${this.isFirstMerge})`);
+      return;
+    }
     if (this.autoContinue && this.isPaused) {
       this.log("[StreamingAudioPlayer] autoContinue=true, auto-resuming playback");
       this.autoContinue = false;
@@ -201,6 +259,9 @@ class StreamingAudioPlayer {
     this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
     this.audioChunks = [];
     this.scheduledChunks = 0;
+    this.pendingChunks = [];
+    this.pendingBytesTotal = 0;
+    this.isFirstMerge = true;
     this.pausedTimeOffset = 0;
     this.pausedAt = 0;
     this.pausedAudioContextTime = 0;
@@ -510,6 +571,9 @@ class StreamingAudioPlayer {
     this.activeSources.clear();
     this.audioChunks = [];
     this.scheduledChunks = 0;
+    this.pendingChunks = [];
+    this.pendingBytesTotal = 0;
+    this.isFirstMerge = true;
     this.autoContinue = false;
     this.log("[StreamingAudioPlayer] Playback stopped, state reset");
   }
@@ -570,6 +634,9 @@ class StreamingAudioPlayer {
     }
     this.audioChunks = [];
     this.scheduledChunks = 0;
+    this.pendingChunks = [];
+    this.pendingBytesTotal = 0;
+    this.isFirstMerge = true;
     this.sessionStartTime = 0;
     this.pausedTimeOffset = 0;
     this.pausedAt = 0;
@@ -589,6 +656,9 @@ class StreamingAudioPlayer {
       this.stop();
       this.audioChunks = [];
       this.scheduledChunks = 0;
+      this.pendingChunks = [];
+      this.pendingBytesTotal = 0;
+      this.isFirstMerge = true;
       this.sessionStartTime = 0;
       this.pausedAt = 0;
       this.scheduledTime = 0;

package/dist/core/AvatarController.d.ts

@@ -25,6 +25,7 @@ export declare class AvatarController {
     private renderCallback?;
     private characterHandle;
     private characterId;
+    private useGPUPath;
     private postProcessingConfig;
     private playbackLoopId;
     private lastRenderedFrameIndex;