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

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.0-beta.78] - 2026-02-04
+
+### 🐛 Bugfixes
+- **Telemetry Accuracy** - Fixed environment field reporting issue in analytics events
+
+### ✨ New Features
+- **Performance Monitoring** - Added loading performance metrics for avatar resources
+  - `fetch_avatar_latency` - Total loading time
+  - `fetch_avatar_metadata_latency` - Metadata fetch time
+  - `download_avatar_assets_latency` - Asset download time
+
+### 🔧 Improvements
+- **Internal Architecture** - Unified configuration constants across platforms for better maintainability
+
 ## [1.0.0-beta.74] - 2026-01-22
 
 ### 🔧 Improvements

package/dist/{StreamingAudioPlayer-BtOgYxcz.js → StreamingAudioPlayer-BNj8LpDw.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-CTh2onXJ.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-DEJMvfST.js";
 class StreamingAudioPlayer {
   // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {
@@ -40,18 +40,6 @@ 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);
@@ -165,37 +153,6 @@ 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)
    */
@@ -209,29 +166,14 @@ class StreamingAudioPlayer {
         logger.errorWithError("[StreamingAudioPlayer] Failed to ensure AudioContext running in addChunk:", err);
       });
     }
-    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;
-    }
+    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 (this.autoContinue && this.isPaused) {
       this.log("[StreamingAudioPlayer] autoContinue=true, auto-resuming playback");
       this.autoContinue = false;
@@ -259,9 +201,6 @@ 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;
@@ -571,9 +510,6 @@ 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");
   }
@@ -634,9 +570,6 @@ class StreamingAudioPlayer {
     }
     this.audioChunks = [];
     this.scheduledChunks = 0;
-    this.pendingChunks = [];
-    this.pendingBytesTotal = 0;
-    this.isFirstMerge = true;
     this.sessionStartTime = 0;
     this.pausedTimeOffset = 0;
     this.pausedAt = 0;
@@ -656,9 +589,6 @@ 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,7 +25,6 @@ export declare class AvatarController {
     private renderCallback?;
     private characterHandle;
     private characterId;
-    private useGPUPath;
     private postProcessingConfig;
     private playbackLoopId;
     private lastRenderedFrameIndex;

package/dist/core/AvatarManager.d.ts

@@ -4,9 +4,12 @@ export declare class AvatarManager {
     private static _instance;
     private avatarDownloader;
     private avatarCache;
-    private loadingPromises;
+    /** 下载队列：FIFO 顺序 */
     private downloadQueue;
-    private isDownloading;
+    /** 当前正在执行的任务 */
+    private currentTask;
+    /** 任务索引：快速查找 id 对应的任务 */
+    private taskIndex;
     /**
      * Access via global singleton
      */
@@ -18,6 +21,12 @@ export declare class AvatarManager {
      * @returns Promise<Avatar>
      */
     load(id: string, onProgress?: (progress: LoadProgressInfo) => void): Promise<Avatar>;
+    /**
+     * Cancel a pending or running download task
+     * @param id Avatar ID to cancel
+     * @returns true if task was found and cancelled
+     */
+    cancelLoad(id: string): boolean;
     /**
      * Get cached avatar
      * @param id Avatar ID
@@ -30,7 +39,7 @@ export declare class AvatarManager {
      */
     clear(id: string): void;
     /**
-     * Clear all avatar cache and resource loader cache
+     * Clear all avatar cache and cancel all tasks
      */
     clearAll(): void;
 }

package/dist/core/AvatarView.d.ts

@@ -30,6 +30,7 @@ export declare class AvatarView {
     private characterHandle;
     private characterId;
     private isPureRenderingMode;
+    private _renderingEnabled;
     private avatarActiveTimer;
     private readonly AVATAR_ACTIVE_INTERVAL;
     /**
@@ -61,6 +62,38 @@ export declare class AvatarView {
         frameCount: number;
         useLinear?: boolean;
     }): Promise<KeyframeData[]>;
+    /**
+     * Pause rendering loop
+     *
+     * When called:
+     * - Rendering loop stops (no GPU/canvas updates)
+     * - Audio playback continues normally
+     * - Animation state machine continues running
+     *
+     * Use `resumeRendering()` to resume rendering.
+     *
+     * @example
+     * // Stop rendering to save GPU resources (audio continues)
+     * avatarView.pauseRendering()
+     */
+    pauseRendering(): void;
+    /**
+     * Resume rendering loop
+     *
+     * When called:
+     * - Rendering loop resumes from current state
+     * - If in Idle state, immediately renders current frame to restore display
+     *
+     * @example
+     * // Resume rendering
+     * avatarView.resumeRendering()
+     */
+    resumeRendering(): void;
+    /**
+     * Check if rendering is currently enabled
+     * @returns true if rendering is enabled, false if paused
+     */
+    isRenderingEnabled(): boolean;
     /**
      * Get or set avatar transform in canvas
      *