@spatialwalk/avatarkit 1.0.0-beta.76 → 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-CuNtk6eL.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-ZN-iK3b8.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) {

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
      *

package/dist/{index-ZN-iK3b8.js → index-DEJMvfST.js}

@@ -1400,6 +1400,32 @@ function base64FromBytes$1(arr) {
 function isSet$1(value) {
   return value !== null && value !== void 0;
 }
+function convertProtoFlameToWasmParams(protoFlame) {
+  var _a;
+  return {
+    translation: protoFlame.translation || [0, 0, 0],
+    rotation: protoFlame.rotation || [0, 0, 0],
+    neck_pose: protoFlame.neckPose || [0, 0, 0],
+    jaw_pose: protoFlame.jawPose || [0, 0, 0],
+    eyes_pose: protoFlame.eyePose || [0, 0, 0, 0, 0, 0],
+    eyelid: protoFlame.eyeLid || [0, 0],
+    expr_params: protoFlame.expression || [],
+    shape_params: [],
+    // Realtime doesn't provide shape params, use default
+    has_eyelid: (((_a = protoFlame.eyeLid) == null ? void 0 : _a.length) || 0) > 0
+  };
+}
+function convertWasmParamsToProtoFlame(wasmParams) {
+  return {
+    translation: wasmParams.translation || [0, 0, 0],
+    rotation: wasmParams.rotation || [0, 0, 0],
+    neckPose: wasmParams.neck_pose || [0, 0, 0],
+    jawPose: wasmParams.jaw_pose || [0, 0, 0],
+    eyePose: wasmParams.eyes_pose || [0, 0, 0, 0, 0, 0],
+    eyeLid: wasmParams.eyelid || [0, 0],
+    expression: wasmParams.expr_params || []
+  };
+}
 const POSTHOG_HOST_INTL = "https://i.spatialwalk.ai";
 const POSTHOG_API_KEY_INTL = "phc_IFTLa6Z6VhTaNvsxB7klvG2JeNwcSpnnwz8YvZRC96Q";
 function getPostHogConfig(_environment) {
@@ -1452,32 +1478,6 @@ const APP_CONFIG = {
     }
   }
 };
-function convertProtoFlameToWasmParams(protoFlame) {
-  var _a;
-  return {
-    translation: protoFlame.translation || [0, 0, 0],
-    rotation: protoFlame.rotation || [0, 0, 0],
-    neck_pose: protoFlame.neckPose || [0, 0, 0],
-    jaw_pose: protoFlame.jawPose || [0, 0, 0],
-    eyes_pose: protoFlame.eyePose || [0, 0, 0, 0, 0, 0],
-    eyelid: protoFlame.eyeLid || [0, 0],
-    expr_params: protoFlame.expression || [],
-    shape_params: [],
-    // Realtime doesn't provide shape params, use default
-    has_eyelid: (((_a = protoFlame.eyeLid) == null ? void 0 : _a.length) || 0) > 0
-  };
-}
-function convertWasmParamsToProtoFlame(wasmParams) {
-  return {
-    translation: wasmParams.translation || [0, 0, 0],
-    rotation: wasmParams.rotation || [0, 0, 0],
-    neckPose: wasmParams.neck_pose || [0, 0, 0],
-    jawPose: wasmParams.jaw_pose || [0, 0, 0],
-    eyePose: wasmParams.eyes_pose || [0, 0, 0, 0, 0, 0],
-    eyeLid: wasmParams.eyelid || [0, 0],
-    expression: wasmParams.expr_params || []
-  };
-}
 var t = "undefined" != typeof window ? window : void 0, i = "undefined" != typeof globalThis ? globalThis : t;
 "undefined" == typeof self && (i.self = i), "undefined" == typeof File && (i.File = function() {
 });
@@ -7294,7 +7294,6 @@ function extractResourceUrls(meta) {
 var Environment = /* @__PURE__ */ ((Environment2) => {
   Environment2["cn"] = "cn";
   Environment2["intl"] = "intl";
-  Environment2["test"] = "test";
   return Environment2;
 })(Environment || {});
 var DrivingServiceMode = /* @__PURE__ */ ((DrivingServiceMode2) => {
@@ -7944,7 +7943,8 @@ function getCommonFields() {
   return {
     platform: "Web",
     sdk_version: sdkVersion,
-    environment: currentEnvironment || "unknown",
+    env: currentEnvironment || "unknown",
+    // environment 缩写为 env
     app_id: logContext.app_id || "",
     user_id: logContext.user_id || "",
     // 没有就传空字符串
@@ -8139,7 +8139,6 @@ function cleanupPostHog() {
 }
 function logEvent(event, level = "info", contents = {}) {
   const context = {
-    environment: currentEnvironment || "unknown",
     sessionToken: idManager.getSessionToken() ?? "",
     userId: idManager.getUserId() ?? "",
     ...contents
@@ -8244,7 +8243,7 @@ const _AnimationPlayer = class _AnimationPlayer {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-CuNtk6eL.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-BNj8LpDw.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -8443,10 +8442,42 @@ const _AnimationPlayer = class _AnimationPlayer {
 };
 __publicField(_AnimationPlayer, "audioUnlocked", false);
 let AnimationPlayer = _AnimationPlayer;
+const FLAME_FRAME_RATE = 25;
+const START_TRANSITION_DURATION_S = 0.2;
+const END_TRANSITION_DURATION_S = 1.6;
+const START_TRANSITION_DURATION_MS = START_TRANSITION_DURATION_S * 1e3;
+const END_TRANSITION_DURATION_MS = END_TRANSITION_DURATION_S * 1e3;
+const AUDIO_SAMPLE_RATE = 16e3;
+const AUDIO_CHANNELS = 1;
+const AUDIO_BYTES_PER_SAMPLE = 2;
+const AUDIO_BYTES_PER_SECOND = AUDIO_SAMPLE_RATE * AUDIO_CHANNELS * AUDIO_BYTES_PER_SAMPLE;
+const BEZIER_CURVES$1 = {
+  /** 下颌: 快速启动，平滑停止 */
+  jaw: [0.2, 0.8, 0.3, 1],
+  /** 表情: 平滑 S 曲线 */
+  expression: [0.4, 0, 0.2, 1],
+  /** 眼部: 柔和 S 曲线 */
+  eye: [0.3, 0, 0.1, 1],
+  /** 颈部: 慢启动，惯性停止 */
+  neck: [0.1, 0.2, 0.2, 1],
+  /** 全局: 标准 ease-in-out */
+  global: [0.42, 0, 0.58, 1]
+};
+const TIME_SCALE = {
+  /** 下颌: 40% 时间完成 (1/2.5) */
+  jaw: 2.5,
+  /** 表情: 62.5% 时间完成 (1/1.6) */
+  expression: 1.6,
+  /** 眼部: 77% 时间完成 (1/1.3) */
+  eye: 1.3,
+  /** 颈部: 100% 时间完成 */
+  neck: 1,
+  /** 全局: 100% 时间完成 */
+  global: 1
+};
 const DEFAULT_SDK_CONFIG = {
   [Environment.cn]: "https://api.open.spatialwalk.top",
-  [Environment.intl]: "https://api.intl.spatialwalk.cloud",
-  [Environment.test]: "https://api-test.spatialwalk.top"
+  [Environment.intl]: "https://api.intl.spatialwalk.cloud"
 };
 const configCache = {
   config: null,
@@ -8484,9 +8515,6 @@ async function fetchSdkConfig(version) {
       } else if (data.endpoints.intl) {
         config[Environment.intl] = `https://${data.endpoints.intl}`;
       }
-      if (data.endpoints.test) {
-        config[Environment.test] = `https://${data.endpoints.test}`;
-      }
       configCache.config = config;
       logger.log(`[SdkConfigLoader] SDK config fetched successfully:`, config);
     } catch (error) {
@@ -9941,7 +9969,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.76");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.78");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -11819,7 +11847,7 @@ class AvatarController {
       recvFirstFlameTimestamp: 0,
       didRecvFirstFlame: false
     });
-    __publicField(this, "audioBytesPerSecond", 16e3 * 2);
+    __publicField(this, "audioBytesPerSecond", AUDIO_BYTES_PER_SECOND);
     this.avatar = avatar;
     this.playbackMode = (options == null ? void 0 : options.playbackMode) ?? DrivingServiceMode.sdk;
     if (this.playbackMode === DrivingServiceMode.sdk) {
@@ -12726,7 +12754,7 @@ class AvatarController {
     if (this.playbackLoopId) {
       return;
     }
-    const fps = APP_CONFIG.animation.fps;
+    const fps = FLAME_FRAME_RATE;
     const playLoop = async () => {
       if (!this.isPlaying || this.currentState === AvatarState.paused || !this.animationPlayer) {
         this.playbackLoopId = null;
@@ -13296,47 +13324,71 @@ function getCacheInfo(url, response) {
   };
 }
 async function downloadResource(url, options) {
+  const { signal, characterId, resourceType, maxRetries = 3 } = options || {};
+  if (signal == null ? void 0 : signal.aborted) {
+    throw new Error("Download cancelled");
+  }
   try {
     let cached = null;
     let pwaCacheSubtype = void 0;
-    if (options == null ? void 0 : options.characterId) {
-      cached = await PwaCacheManager.getCharacterResource(options.characterId, url);
+    if (characterId) {
+      cached = await PwaCacheManager.getCharacterResource(characterId, url);
       if (cached) {
         pwaCacheSubtype = "character";
       }
-    } else if ((options == null ? void 0 : options.resourceType) === "template") {
+    } else if (resourceType === "template") {
       cached = await PwaCacheManager.getTemplateResource(url);
       if (cached) {
         pwaCacheSubtype = "template";
       }
     }
     if (cached) {
-      const response2 = new Response(cached);
+      const response = new Response(cached);
       await new Promise((resolve2) => setTimeout(resolve2, 0));
-      const cacheInfo2 = getCacheInfo(url, response2);
-      cacheInfo2.cacheHit = true;
-      cacheInfo2.cacheType = "pwa";
-      cacheInfo2.pwaCacheSubtype = pwaCacheSubtype;
-      return { data: cached, cacheInfo: cacheInfo2 };
-    }
-    const response = await fetch(url);
-    if (!response.ok) {
-      throw new Error(`HTTP ${response.status} ${response.statusText}`);
-    }
-    const arrayBuffer = await response.arrayBuffer();
-    if (options == null ? void 0 : options.characterId) {
-      PwaCacheManager.putCharacterResource(options.characterId, url, arrayBuffer).catch((err) => {
-        logger.warn(`[downloadResource] Failed to cache character resource:`, err);
-      });
-    } else if ((options == null ? void 0 : options.resourceType) === "template") {
-      PwaCacheManager.putTemplateResource(url, arrayBuffer).catch((err) => {
-        logger.warn(`[downloadResource] Failed to cache template resource:`, err);
-      });
+      const cacheInfo = getCacheInfo(url, response);
+      cacheInfo.cacheHit = true;
+      cacheInfo.cacheType = "pwa";
+      cacheInfo.pwaCacheSubtype = pwaCacheSubtype;
+      return { data: cached, cacheInfo };
+    }
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      if (signal == null ? void 0 : signal.aborted) {
+        throw new Error("Download cancelled");
+      }
+      try {
+        const response = await fetch(url, { signal });
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status} ${response.statusText}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        if (characterId) {
+          PwaCacheManager.putCharacterResource(characterId, url, arrayBuffer).catch((err) => {
+            logger.warn(`[downloadResource] Failed to cache character resource:`, err);
+          });
+        } else if (resourceType === "template") {
+          PwaCacheManager.putTemplateResource(url, arrayBuffer).catch((err) => {
+            logger.warn(`[downloadResource] Failed to cache template resource:`, err);
+          });
+        }
+        await new Promise((resolve2) => setTimeout(resolve2, 0));
+        const cacheInfo = getCacheInfo(url, response);
+        return { data: arrayBuffer, cacheInfo };
+      } catch (err) {
+        if (err instanceof Error && (err.name === "AbortError" || err.message === "Download cancelled")) {
+          throw err;
+        }
+        lastError = err instanceof Error ? err : new Error(String(err));
+        if (attempt < maxRetries) {
+          logger.warn(`[downloadResource] Attempt ${attempt}/${maxRetries} failed for ${url}, retrying immediately...`);
+        }
+      }
     }
-    await new Promise((resolve2) => setTimeout(resolve2, 0));
-    const cacheInfo = getCacheInfo(url, response);
-    return { data: arrayBuffer, cacheInfo };
+    throw lastError || new Error(`Failed to download ${url} after ${maxRetries} attempts`);
   } catch (err) {
+    if (err instanceof Error && (err.name === "AbortError" || err.message === "Download cancelled")) {
+      throw err;
+    }
     const msg = errorToMessage(err);
     throw new Error(`[downloadResource] ${url} → ${msg}`);
   }
@@ -13482,16 +13534,21 @@ class AvatarDownloader {
    * Load camera settings from CharacterMeta (optional)
    * @internal
    */
-  async loadCameraSettings(characterMeta) {
+  async loadCameraSettings(characterMeta, options) {
     var _a, _b;
+    const { signal } = options || {};
     const cameraUrl = (_b = (_a = characterMeta.camera) == null ? void 0 : _a.resource) == null ? void 0 : _b.remote;
     if (!cameraUrl) {
       logger.log("ℹ️ No camera resource URL provided");
       return void 0;
     }
+    if (signal == null ? void 0 : signal.aborted) {
+      throw new Error("Load cancelled");
+    }
     try {
       logger.log(`📥 Loading camera info from: ${cameraUrl}`);
       const { data: arrayBuffer } = await downloadResource(cameraUrl, {
+        signal,
         characterId: characterMeta.characterId ?? void 0,
         resourceType: "character"
       });
@@ -13510,7 +13567,10 @@ class AvatarDownloader {
    */
   async loadCharacterData(characterMeta, options) {
     var _a, _b, _c, _d, _e2, _f, _g, _h, _i2, _j;
-    const { progressCallback = null } = options || {};
+    const { progressCallback = null, signal } = options || {};
+    if (signal == null ? void 0 : signal.aborted) {
+      throw new Error("Download cancelled");
+    }
     const totalStartTime = Date.now();
     const shapeUrl = (_c = (_b = (_a = characterMeta.models) == null ? void 0 : _a.shape) == null ? void 0 : _b.resource) == null ? void 0 : _c.remote;
     const pointCloudUrl = (_f = (_e2 = (_d = characterMeta.models) == null ? void 0 : _d.gsStandard) == null ? void 0 : _e2.resource) == null ? void 0 : _f.remote;
@@ -13553,6 +13613,7 @@ class AvatarDownloader {
       updateProgress(filename, false);
       try {
         const { data: arrayBuffer, cacheInfo } = await downloadResource(url, {
+          signal,
           characterId: characterMeta.characterId ?? void 0,
           resourceType: "character"
         });
@@ -13567,6 +13628,9 @@ class AvatarDownloader {
         updateProgress(filename, true);
         return { key, success: true, size: arrayBuffer.byteLength };
       } catch (error) {
+        if (error instanceof Error && (error.name === "AbortError" || error.message === "Download cancelled")) {
+          throw error;
+        }
         if (!optional) {
           const errorMessage = error instanceof Error ? error.message : String(error);
           logEvent("download_avatar_assets_failed", "error", {
@@ -13599,9 +13663,12 @@ class AvatarDownloader {
     const totalSize = Object.values(characterData).reduce((sum, buffer) => {
       return sum + (buffer ? buffer.byteLength : 0);
     }, 0);
-    logEvent("download_avatar_assets_total_measure", "info", {
+    logEvent("download_avatar_assets_latency", "info", {
+      resolution: "default",
+      // 目前写死 default
       avatar_id: characterMeta.characterId ?? "unknown",
-      total_duration: totalDuration,
+      duration: totalDuration,
+      // 保留其他有用的字段
       parallel_duration: parallelDuration,
       total_size: totalSize,
       file_count: filesToLoad.length,
@@ -13615,9 +13682,13 @@ class AvatarDownloader {
    * @internal
    */
   async preloadResources(characterMeta, options) {
-    const { progressCallback = null } = options || {};
+    const { progressCallback = null, signal } = options || {};
+    if (signal == null ? void 0 : signal.aborted) {
+      throw new Error("Preload cancelled");
+    }
     const [characterData, preloadCameraSettings] = await Promise.all([
       this.loadCharacterData(characterMeta, {
+        signal,
         progressCallback: (info) => {
           if (progressCallback) {
             progressCallback({
@@ -13627,7 +13698,7 @@ class AvatarDownloader {
           }
         }
       }),
-      this.loadCameraSettings(characterMeta)
+      this.loadCameraSettings(characterMeta, { signal })
     ]);
     return {
       characterData,
@@ -13661,7 +13732,8 @@ class AvatarDownloader {
               ...headers,
               ...options.headers
             },
-            body: options.body ? JSON.stringify(options.body) : void 0
+            body: options.body ? JSON.stringify(options.body) : void 0,
+            signal: options.signal
           });
           if (!response.ok) {
             let error;
@@ -13694,16 +13766,21 @@ class AvatarDownloader {
    * Returns CharacterMeta with nested resource structure
    * @internal
    */
-  async getCharacterById(characterId) {
+  async getCharacterById(characterId, options) {
     var _a;
+    const { signal } = options || {};
     const startTime = Date.now();
     try {
+      if (signal == null ? void 0 : signal.aborted) {
+        throw new Error("Request cancelled");
+      }
       const client = this.getSdkApiClient();
       const response = await client.request(`/v2/character/${characterId}`, {
-        method: "GET"
+        method: "GET",
+        signal
       });
       const duration = Date.now() - startTime;
-      logEvent("fetch_avatar_metadata_measure", "info", {
+      logEvent("fetch_avatar_metadata_latency", "info", {
         avatar_id: characterId,
         duration
       });
@@ -13735,10 +13812,12 @@ const _AvatarManager = class _AvatarManager {
   constructor() {
     __publicField(this, "avatarDownloader", null);
     __publicField(this, "avatarCache", /* @__PURE__ */ new Map());
-    __publicField(this, "loadingPromises", /* @__PURE__ */ new Map());
-    // 下载队列：确保资源下载串行执行
+    /** 下载队列：FIFO 顺序 */
     __publicField(this, "downloadQueue", []);
-    __publicField(this, "isDownloading", false);
+    /** 当前正在执行的任务 */
+    __publicField(this, "currentTask", null);
+    /** 任务索引：快速查找 id 对应的任务 */
+    __publicField(this, "taskIndex", /* @__PURE__ */ new Map());
   }
   /**
    * Access via global singleton
@@ -13756,28 +13835,139 @@ const _AvatarManager = class _AvatarManager {
    * @returns Promise<Avatar>
    */
   async load(id, onProgress) {
-    const loadingPromise = this.loadingPromises.get(id);
-    if (loadingPromise) {
-      logger.log(`[AvatarManager] Avatar ${id} is already loading, reusing promise`);
-      return loadingPromise;
-    }
     if (!AvatarSDK.isInitialized) {
       throw new Error("AvatarSDK not initialized. Please call AvatarSDK.initialize() first.");
     }
     if (!this.avatarDownloader) {
       this.avatarDownloader = new AvatarDownloader();
     }
-    logger.log(`[AvatarManager] Fetching latest metadata for avatar ${id}...`);
-    onProgress == null ? void 0 : onProgress({ type: LoadProgress.downloading, progress: 5 });
-    const newCharacterMeta = await this.avatarDownloader.getCharacterById(id);
+    const existingTask = this.taskIndex.get(id);
+    if (existingTask && existingTask.status !== "completed" && existingTask.status !== "failed" && existingTask.status !== "cancelled") {
+      logger.log(`[AvatarManager] Avatar ${id} already in queue/loading, adding callback to existing task`);
+      onProgress == null ? void 0 : onProgress({ type: LoadProgress.downloading, progress: 0 });
+      return new Promise((resolve2, reject) => {
+        existingTask.requests.push({ onProgress, resolve: resolve2, reject });
+      });
+    }
+    logger.log(`[AvatarManager] Queuing new avatar download for id: ${id}`);
+    let taskResolve;
+    let taskReject;
+    const taskPromise = new Promise((resolve2, reject) => {
+      taskResolve = resolve2;
+      taskReject = reject;
+    });
+    const task = {
+      id,
+      status: "queued",
+      requests: [{ onProgress, resolve: taskResolve, reject: taskReject }],
+      abortController: new AbortController(),
+      promise: taskPromise,
+      _resolve: taskResolve,
+      _reject: taskReject
+    };
+    onProgress == null ? void 0 : onProgress({ type: LoadProgress.downloading, progress: 0 });
+    this.downloadQueue.push(task);
+    this.taskIndex.set(id, task);
+    this.processQueue();
+    return taskPromise;
+  }
+  /**
+   * Cancel a pending or running download task
+   * @param id Avatar ID to cancel
+   * @returns true if task was found and cancelled
+   */
+  cancelLoad(id) {
+    const task = this.taskIndex.get(id);
+    if (!task) {
+      logger.log(`[AvatarManager] No task found for id: ${id}`);
+      return false;
+    }
+    if (task.status === "completed" || task.status === "failed" || task.status === "cancelled") {
+      logger.log(`[AvatarManager] Task ${id} already finished with status: ${task.status}`);
+      return false;
+    }
+    logger.log(`[AvatarManager] Cancelling task for id: ${id}`);
+    task.abortController.abort();
+    task.status = "cancelled";
+    const cancelError = new Error(`Download cancelled for avatar: ${id}`);
+    this.notifyAllRequests(task, { type: LoadProgress.failed, error: cancelError });
+    task.requests.forEach((req) => req.reject(cancelError));
+    this.taskIndex.delete(id);
+    const queueIndex = this.downloadQueue.indexOf(task);
+    if (queueIndex !== -1) {
+      this.downloadQueue.splice(queueIndex, 1);
+    }
+    if (this.currentTask === task) {
+      this.currentTask = null;
+      this.processQueue();
+    }
+    return true;
+  }
+  /**
+   * Process download queue (FIFO)
+   * @internal
+   */
+  async processQueue() {
+    var _a, _b;
+    if (this.currentTask || this.downloadQueue.length === 0) {
+      return;
+    }
+    const task = this.downloadQueue.shift();
+    this.currentTask = task;
+    logger.log(`[AvatarManager] Processing task: ${task.id} (${this.downloadQueue.length} items remaining)`);
+    try {
+      const avatar = await this.executeTask(task);
+      if (task.status === "cancelled") {
+        return;
+      }
+      task.status = "completed";
+      this.notifyAllRequests(task, { type: LoadProgress.completed });
+      task.requests.forEach((req) => req.resolve(avatar));
+      (_a = task._resolve) == null ? void 0 : _a.call(task, avatar);
+    } catch (error) {
+      if (task.status === "cancelled") {
+        return;
+      }
+      task.status = "failed";
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.notifyAllRequests(task, { type: LoadProgress.failed, error: err });
+      task.requests.forEach((req) => req.reject(err));
+      (_b = task._reject) == null ? void 0 : _b.call(task, err);
+    } finally {
+      if (task.status !== "cancelled") {
+        this.taskIndex.delete(task.id);
+      }
+      this.currentTask = null;
+      this.processQueue();
+    }
+  }
+  /**
+   * Execute a single download task
+   * @internal
+   */
+  async executeTask(task) {
+    const { id, abortController } = task;
+    const signal = abortController.signal;
+    const startTime = Date.now();
+    if (signal.aborted) {
+      throw new Error("Task cancelled");
+    }
+    task.status = "fetching-meta";
+    logger.log(`[AvatarManager] Fetching metadata for avatar ${id}...`);
+    const characterMeta = await this.avatarDownloader.getCharacterById(id, { signal });
+    task.characterMeta = characterMeta;
+    if (signal.aborted) {
+      throw new Error("Task cancelled");
+    }
     const cached = this.avatarCache.get(id);
     if (cached) {
       const cachedMeta = cached.getCharacterMeta();
       const cachedVersion = cachedMeta.version;
-      const newVersion = newCharacterMeta.version;
+      const newVersion = characterMeta.version;
       if (cachedVersion === newVersion) {
-        logger.log(`[AvatarManager] Avatar ${id} found in cache with same version (${cachedVersion}), updating meta and returning cached`);
-        cached.updateCharacterMeta(newCharacterMeta);
+        logger.log(`[AvatarManager] Avatar ${id} found in cache with same version (${cachedVersion}), returning cached`);
+        cached.updateCharacterMeta(characterMeta);
+        this.notifyAllRequests(task, { type: LoadProgress.downloading, progress: 100 });
         return cached;
       } else {
         logger.log(`[AvatarManager] Avatar ${id} version mismatch: cached=${cachedVersion}, new=${newVersion}, reloading...`);
@@ -13786,77 +13976,71 @@ const _AvatarManager = class _AvatarManager {
         await PwaCacheManager2.clearCharacterCache(id);
       }
     }
-    logger.log(`[AvatarManager] Queuing avatar download for id: ${id}`);
-    const loadPromise = new Promise((resolve2, reject) => {
-      this.downloadQueue.push({
-        id,
-        characterMeta: newCharacterMeta,
-        onProgress,
-        resolve: resolve2,
-        reject
-      });
+    const totalAssets = this.countTotalAssets(characterMeta);
+    const metaProgress = Math.round(1 / (1 + totalAssets) * 100);
+    this.notifyAllRequests(task, { type: LoadProgress.downloading, progress: metaProgress });
+    if (signal.aborted) {
+      throw new Error("Task cancelled");
+    }
+    task.status = "downloading";
+    logger.log("[AvatarManager] Downloading resources...");
+    let downloadedCount = 0;
+    const resources = await this.avatarDownloader.preloadResources(characterMeta, {
+      signal,
+      progressCallback: (info) => {
+        if (info.loaded > downloadedCount) {
+          downloadedCount = info.loaded;
+          const progress = Math.round((1 + downloadedCount) / (1 + totalAssets) * 100);
+          this.notifyAllRequests(task, { type: LoadProgress.downloading, progress });
+        }
+      }
     });
-    this.loadingPromises.set(id, loadPromise);
-    loadPromise.finally(() => {
-      this.loadingPromises.delete(id);
+    if (signal.aborted) {
+      throw new Error("Task cancelled");
+    }
+    logger.log("[AvatarManager] Creating Avatar instance...");
+    const avatar = new Avatar(id, characterMeta, resources);
+    this.avatarCache.set(id, avatar);
+    logger.log("[AvatarManager] Avatar loaded successfully");
+    const totalDuration = Date.now() - startTime;
+    logEvent("fetch_avatar_latency", "info", {
+      resolution: "default",
+      // 目前写死 default
+      avatar_id: id,
+      duration: totalDuration
     });
-    this.processDownloadQueue();
-    return loadPromise;
+    logEvent("character_load", "info", {
+      avatar_id: id,
+      event: "load_success"
+    });
+    return avatar;
   }
   /**
-   * Process download queue (ensure serial execution)
+   * 计算需要下载的资源总数
    * @internal
    */
-  async processDownloadQueue() {
-    if (this.isDownloading || this.downloadQueue.length === 0) {
-      return;
-    }
-    this.isDownloading = true;
-    const item = this.downloadQueue.shift();
-    logger.log(`[AvatarManager] Processing download queue item: ${item.id} (${this.downloadQueue.length} items remaining)`);
-    try {
-      const avatar = await this.doLoad(item.id, item.characterMeta, item.onProgress);
-      item.resolve(avatar);
-    } catch (error) {
-      item.reject(error instanceof Error ? error : new Error(String(error)));
-    } finally {
-      this.isDownloading = false;
-      this.processDownloadQueue();
-    }
+  countTotalAssets(meta) {
+    var _a, _b, _c, _d, _e2, _f, _g, _h, _i2, _j, _k;
+    let count = 0;
+    if ((_c = (_b = (_a = meta.models) == null ? void 0 : _a.shape) == null ? void 0 : _b.resource) == null ? void 0 : _c.remote) count++;
+    if ((_f = (_e2 = (_d = meta.models) == null ? void 0 : _d.gsStandard) == null ? void 0 : _e2.resource) == null ? void 0 : _f.remote) count++;
+    if ((_i2 = (_h = (_g = meta.animations) == null ? void 0 : _g.frameIdle) == null ? void 0 : _h.resource) == null ? void 0 : _i2.remote) count++;
+    if ((_k = (_j = meta.camera) == null ? void 0 : _j.resource) == null ? void 0 : _k.remote) count++;
+    return count;
   }
   /**
-   * Execute actual loading logic (private method)
+   * 通知所有请求者进度更新
    * @internal
    */
-  async doLoad(id, characterMeta, onProgress) {
-    try {
-      logger.log("[AvatarManager] Step 1: Downloading resources...");
-      onProgress == null ? void 0 : onProgress({ type: LoadProgress.downloading, progress: 30 });
-      const resources = await this.avatarDownloader.preloadResources(characterMeta, {
-        progressCallback: (info) => {
-          const externalProgress = 30 + info.progress / 100 * 70;
-          onProgress == null ? void 0 : onProgress({
-            type: LoadProgress.downloading,
-            progress: Math.round(externalProgress)
-          });
-        }
-      });
-      logger.log("[AvatarManager] Step 2: Creating Avatar instance...");
-      const avatar = new Avatar(id, characterMeta, resources);
-      this.avatarCache.set(id, avatar);
-      logger.log("[AvatarManager] Avatar loaded successfully");
-      onProgress == null ? void 0 : onProgress({ type: LoadProgress.completed });
-      logEvent("character_load", "info", {
-        avatar_id: id,
-        event: "load_success"
-      });
-      return avatar;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      logger.error("Failed to load avatar:", message);
-      onProgress == null ? void 0 : onProgress({ type: LoadProgress.failed, error });
-      throw error;
-    }
+  notifyAllRequests(task, progress) {
+    task.requests.forEach((req) => {
+      var _a;
+      try {
+        (_a = req.onProgress) == null ? void 0 : _a.call(req, progress);
+      } catch (err) {
+        logger.warn(`[AvatarManager] Error in progress callback:`, err);
+      }
+    });
   }
   /**
    * Get cached avatar
@@ -13871,17 +14055,53 @@ const _AvatarManager = class _AvatarManager {
    * @param id Avatar ID
    */
   clear(id) {
+    this.cancelLoad(id);
     const removed = this.avatarCache.delete(id);
     if (removed) {
       logger.log(`[AvatarManager] Cleared avatar cache for id: ${id}`);
     }
   }
   /**
-   * Clear all avatar cache and resource loader cache
+   * Clear all avatar cache and cancel all tasks
    */
   clearAll() {
+    for (const task of this.taskIndex.values()) {
+      if (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
+        this.cancelLoad(task.id);
+      }
+    }
     this.avatarCache.clear();
-    logger.log("[AvatarManager] Cleared all avatar cache");
+    this.downloadQueue = [];
+    this.taskIndex.clear();
+    this.currentTask = null;
+    logger.log("[AvatarManager] Cleared all avatar cache and cancelled all tasks");
+  }
+  /**
+   * Get the number of pending tasks in the queue
+   * @internal For testing purposes
+   */
+  get pendingTaskCount() {
+    return this.downloadQueue.length + (this.currentTask ? 1 : 0);
+  }
+  /**
+   * Check if a task is in progress for the given ID
+   * @internal For testing purposes
+   */
+  isLoading(id) {
+    const task = this.taskIndex.get(id);
+    return task !== void 0 && task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled";
+  }
+  /**
+   * @internal For testing - get loadingPromises map (compatibility)
+   */
+  get loadingPromises() {
+    const map = /* @__PURE__ */ new Map();
+    for (const [id, task] of this.taskIndex) {
+      if (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
+        map.set(id, task.promise);
+      }
+    }
+    return map;
   }
 };
 __publicField(_AvatarManager, "_instance", null);
@@ -15556,7 +15776,7 @@ function linearLerp(from, to2, progress) {
     expression: lerpArrays(from.expression || [], to2.expression || [], progress)
   };
 }
-function generateTransitionFramesLinear(from, to2, durationMs, fps = 25) {
+function generateTransitionFramesLinear(from, to2, durationMs, fps = FLAME_FRAME_RATE) {
   const steps = Math.max(1, Math.floor(durationMs / 1e3 * fps));
   const frames = Array.from({ length: steps });
   if (steps === 1) {
@@ -15599,27 +15819,11 @@ function createBezierEasing(x1, y1, x2, y2) {
   };
 }
 const BEZIER_CURVES = {
-  // jaw: fast start, smooth stop
-  jaw: createBezierEasing(0.2, 0.8, 0.3, 1),
-  // expression: smooth S curve
-  expression: createBezierEasing(0.4, 0, 0.2, 1),
-  // eye: softer S curve
-  eye: createBezierEasing(0.3, 0, 0.1, 1),
-  // neck: slow start, inertial stop
-  neck: createBezierEasing(0.1, 0.2, 0.2, 1),
-  // global: standard ease-in-out
-  global: createBezierEasing(0.42, 0, 0.58, 1)
-};
-const TIME_SCALE = {
-  jaw: 2.5,
-  // 40% time to complete
-  expression: 1.6,
-  // 62.5% time to complete
-  eye: 1.3,
-  // 77% time to complete
-  neck: 1,
-  // 100% time to complete
-  global: 1
+  jaw: createBezierEasing(...BEZIER_CURVES$1.jaw),
+  expression: createBezierEasing(...BEZIER_CURVES$1.expression),
+  eye: createBezierEasing(...BEZIER_CURVES$1.eye),
+  neck: createBezierEasing(...BEZIER_CURVES$1.neck),
+  global: createBezierEasing(...BEZIER_CURVES$1.global)
 };
 function bezierLerp(from, to2, progress) {
   const getT = (key) => {
@@ -15642,7 +15846,7 @@ function bezierLerp(from, to2, progress) {
     expression: lerpArrays(from.expression || [], to2.expression || [], getT("expression"))
   };
 }
-function generateTransitionFrames(from, to2, durationMs, fps = 25) {
+function generateTransitionFrames(from, to2, durationMs, fps = FLAME_FRAME_RATE) {
   const steps = Math.max(1, Math.floor(durationMs / 1e3 * fps));
   const frames = Array.from({ length: steps });
   if (steps === 1) {
@@ -15692,9 +15896,9 @@ class AvatarView {
     // Transition animation data
     __publicField(this, "transitionKeyframes", []);
     __publicField(this, "transitionStartTime", 0);
-    __publicField(this, "startTransitionDurationMs", 200);
+    __publicField(this, "startTransitionDurationMs", START_TRANSITION_DURATION_MS);
     // Idle -> Speaking 过渡时长
-    __publicField(this, "endTransitionDurationMs", 1600);
+    __publicField(this, "endTransitionDurationMs", END_TRANSITION_DURATION_MS);
     // Speaking -> Idle 过渡时长
     __publicField(this, "cachedIdleFirstFrame", null);
     __publicField(this, "idleCurrentFrameIndex", 0);
@@ -15706,6 +15910,8 @@ class AvatarView {
     // Unique ID for this character instance
     // 纯渲染模式标志（阻止 idle 循环渲染）
     __publicField(this, "isPureRenderingMode", false);
+    // 渲染开关标志（控制是否进行渲染循环）
+    __publicField(this, "_renderingEnabled", true);
     // avatar_active 埋点相关
     __publicField(this, "avatarActiveTimer", null);
     __publicField(this, "AVATAR_ACTIVE_INTERVAL", 6e5);
@@ -15777,12 +15983,12 @@ class AvatarView {
       aligned.from,
       aligned.to,
       durationMs,
-      APP_CONFIG.animation.fps
+      FLAME_FRAME_RATE
     ) : generateTransitionFrames(
       aligned.from,
       aligned.to,
       durationMs,
-      APP_CONFIG.animation.fps
+      FLAME_FRAME_RATE
     );
     if (keyframes.length < 2) {
       keyframes = [aligned.from, aligned.to];
@@ -16111,7 +16317,7 @@ class AvatarView {
     }
     this.idleCurrentFrameIndex = 0;
     let lastTime = 0;
-    const targetFPS = APP_CONFIG.animation.fps;
+    const targetFPS = FLAME_FRAME_RATE;
     const frameInterval = 1e3 / targetFPS;
     this.initFPS();
     const renderFrame = async (currentTime) => {
@@ -16133,6 +16339,10 @@ class AvatarView {
           this.idleAnimationLoopId = requestAnimationFrame(renderFrame);
           return;
         }
+        if (!this._renderingEnabled) {
+          this.idleAnimationLoopId = requestAnimationFrame(renderFrame);
+          return;
+        }
         const avatarCore = AvatarSDK.getAvatarCore();
         if (!avatarCore) {
           return;
@@ -16146,8 +16356,7 @@ class AvatarView {
           if (this.isPureRenderingMode) {
             return;
           }
-          this.renderSystem.loadSplatsFromPackedData(splatData);
-          this.renderSystem.renderFrame();
+          this.doRender(splatData);
         }
         this.idleAnimationLoopId = requestAnimationFrame(renderFrame);
       } catch (error) {
@@ -16168,7 +16377,7 @@ class AvatarView {
       this.stopRealtimeAnimationLoop();
     }
     let lastTime = 0;
-    const targetFPS = APP_CONFIG.animation.fps;
+    const targetFPS = FLAME_FRAME_RATE;
     const frameInterval = 1e3 / targetFPS;
     this.initFPS();
     const renderFrame = async (currentTime) => {
@@ -16216,8 +16425,7 @@ class AvatarView {
           if (avatarCore) {
             const sd = await avatarCore.computeFrameFlatFromParams(wasmParams, this.characterHandle ?? void 0);
             if (sd) {
-              this.renderSystem.loadSplatsFromPackedData(sd);
-              this.renderSystem.renderFrame();
+              this.doRender(sd);
             }
           }
           if (progress >= 1) {
@@ -16295,6 +16503,18 @@ class AvatarView {
     this.stopIdleAnimationLoop();
     this.stopRealtimeAnimationLoop();
   }
+  /**
+   * Unified render method - all rendering goes through here
+   * This is the single point of control for renderingEnabled flag
+   * @internal
+   */
+  doRender(splatData) {
+    if (!this.renderSystem || !this._renderingEnabled) {
+      return;
+    }
+    this.renderSystem.loadSplatsFromPackedData(splatData);
+    this.renderSystem.renderFrame();
+  }
   /**
    * Render realtime frame (called by playback layer callback)
    * @internal
@@ -16303,13 +16523,12 @@ class AvatarView {
     if (!this.renderSystem || this.renderingState !== "speaking") {
       return;
     }
-    this.renderSystem.loadSplatsFromPackedData(splatData);
-    this.renderSystem.renderFrame();
     this.lastRenderedFrameIndex = frameIndex;
     if (frameIndex >= 0 && frameIndex < this.currentKeyframes.length) {
       this.lastRealtimeProtoFrame = this.currentKeyframes[frameIndex];
       this.currentPlayingFrame = this.lastRealtimeProtoFrame;
     }
+    this.doRender(splatData);
   }
   /**
    * State transition method
@@ -16676,8 +16895,7 @@ class AvatarView {
         this.characterHandle ?? void 0
       );
       if (splatData) {
-        this.renderSystem.loadSplatsFromPackedData(splatData);
-        this.renderSystem.renderFrame();
+        this.doRender(splatData);
       }
     } catch (error) {
       logger.error("[AvatarView] Failed to render flame:", error instanceof Error ? error.message : String(error));
@@ -16714,7 +16932,7 @@ class AvatarView {
       const aligned = this.alignFlamePair(fromFrame, toFrame);
       const alignedFrom = aligned.from;
       const alignedTo = aligned.to;
-      const fps = APP_CONFIG.animation.fps;
+      const fps = FLAME_FRAME_RATE;
       const durationMs = frameCount / fps * 1e3;
       const transitionFrames = useLinear ? generateTransitionFramesLinear(alignedFrom, alignedTo, durationMs, fps) : generateTransitionFrames(alignedFrom, alignedTo, durationMs, fps);
       transitionFrames[0] = alignedFrom;
@@ -16746,6 +16964,76 @@ class AvatarView {
       this.renderSystem.handleResize();
     }
   }
+  /**
+   * 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() {
+    if (!this._renderingEnabled) {
+      return;
+    }
+    this._renderingEnabled = false;
+    logger.log("[AvatarView] Rendering paused");
+  }
+  /**
+   * 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() {
+    if (this._renderingEnabled) {
+      return;
+    }
+    this._renderingEnabled = true;
+    logger.log("[AvatarView] Rendering resumed");
+    if (this.isInitialized && this.renderSystem && this.renderingState === "idle") {
+      this.renderCurrentIdleFrame();
+    }
+  }
+  /**
+   * Check if rendering is currently enabled
+   * @returns true if rendering is enabled, false if paused
+   */
+  isRenderingEnabled() {
+    return this._renderingEnabled;
+  }
+  /**
+   * Render current idle frame immediately
+   * @internal
+   */
+  async renderCurrentIdleFrame() {
+    const avatarCore = AvatarSDK.getAvatarCore();
+    if (!avatarCore || !this.renderSystem) {
+      return;
+    }
+    try {
+      const splatData = await avatarCore.computeCompleteFrameFlat(
+        { frameIndex: this.idleCurrentFrameIndex },
+        this.characterHandle ?? void 0
+      );
+      if (splatData) {
+        this.doRender(splatData);
+      }
+    } catch (error) {
+      logger.warn("[AvatarView] Failed to render current idle frame:", error);
+    }
+  }
   /**
    * 获取渲染性能统计
    * @returns 渲染性能统计数据，如果渲染系统未初始化则返回 null
@@ -16786,7 +17074,7 @@ class AvatarView {
     const { x: x2, y: y2, scale } = value;
     logger.log(`[AvatarView] Setting transform: x=${x2}, y=${y2}, scale=${scale}`);
     this.renderSystem.setTransform(x2, y2, scale);
-    if (this.isInitialized && this.renderSystem) {
+    if (this.isInitialized && this.renderSystem && this._renderingEnabled) {
       this.renderSystem.renderFrame();
     }
   }

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-ZN-iK3b8.js";
+import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-DEJMvfST.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/internal/constants.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Avatar SDK 内部共享常量
+ * 跨平台统一配置，确保行为一致
+ *
+ * 对应:
+ * - Android: AvatarPlayer.kt 中的 companion object
+ * - iOS: (待实现)
+ *
+ * @internal
+ */
+/** 帧间隔 (毫秒) */
+export declare const FLAME_FRAME_INTERVAL_MS: number;
+/** 开始过渡时长 (秒): idle -> speaking */
+export declare const START_TRANSITION_DURATION_S = 0.2;
+/** 结束过渡时长 (秒): speaking -> idle */
+export declare const END_TRANSITION_DURATION_S = 1.6;
+/** 开始过渡时长 (毫秒) */
+export declare const START_TRANSITION_DURATION_MS: number;
+/** 结束过渡时长 (毫秒) */
+export declare const END_TRANSITION_DURATION_MS: number;
+/** 默认音频采样率 (Hz) */
+export declare const AUDIO_SAMPLE_RATE = 16000;
+/** 音频声道数 (mono) */
+export declare const AUDIO_CHANNELS = 1;
+/** 每样本字节数 (16bit PCM) */
+export declare const AUDIO_BYTES_PER_SAMPLE = 2;
+/** 每秒音频字节数 */
+export declare const AUDIO_BYTES_PER_SECOND: number;
+/**
+ * 各部位插值曲线控制点
+ * 格式: [x1, y1, x2, y2] 对应 cubic-bezier(x1, y1, x2, y2)
+ *
+ * 与 Android FlameFrameData.kt 中的 BEZIER_CURVES 完全一致
+ */
+export declare const BEZIER_CURVES: {
+    /** 下颌: 快速启动，平滑停止 */
+    readonly jaw: readonly [0.2, 0.8, 0.3, 1];
+    /** 表情: 平滑 S 曲线 */
+    readonly expression: readonly [0.4, 0, 0.2, 1];
+    /** 眼部: 柔和 S 曲线 */
+    readonly eye: readonly [0.3, 0, 0.1, 1];
+    /** 颈部: 慢启动，惯性停止 */
+    readonly neck: readonly [0.1, 0.2, 0.2, 1];
+    /** 全局: 标准 ease-in-out */
+    readonly global: readonly [0.42, 0, 0.58, 1];
+};
+/**
+ * 各部位时间缩放因子
+ * 控制各部位完成过渡所需的相对时间
+ *
+ * 与 Android FlameFrameData.kt 中的 TIME_SCALE 完全一致
+ */
+export declare const TIME_SCALE: {
+    /** 下颌: 40% 时间完成 (1/2.5) */
+    readonly jaw: 2.5;
+    /** 表情: 62.5% 时间完成 (1/1.6) */
+    readonly expression: 1.6;
+    /** 眼部: 77% 时间完成 (1/1.3) */
+    readonly eye: 1.3;
+    /** 颈部: 100% 时间完成 */
+    readonly neck: 1;
+    /** 全局: 100% 时间完成 */
+    readonly global: 1;
+};
+export type BezierCurveKey = keyof typeof BEZIER_CURVES;
+export type TimeScaleKey = keyof typeof TIME_SCALE;
+export declare const AvatarConstants: {
+    readonly FLAME_FRAME_RATE: 25;
+    readonly FLAME_FRAME_INTERVAL_MS: number;
+    readonly START_TRANSITION_DURATION_S: 0.2;
+    readonly END_TRANSITION_DURATION_S: 1.6;
+    readonly START_TRANSITION_DURATION_MS: number;
+    readonly END_TRANSITION_DURATION_MS: number;
+    readonly AUDIO_SAMPLE_RATE: 16000;
+    readonly AUDIO_CHANNELS: 1;
+    readonly AUDIO_BYTES_PER_SAMPLE: 2;
+    readonly AUDIO_BYTES_PER_SECOND: number;
+    readonly BEZIER_CURVES: {
+        /** 下颌: 快速启动，平滑停止 */
+        readonly jaw: readonly [0.2, 0.8, 0.3, 1];
+        /** 表情: 平滑 S 曲线 */
+        readonly expression: readonly [0.4, 0, 0.2, 1];
+        /** 眼部: 柔和 S 曲线 */
+        readonly eye: readonly [0.3, 0, 0.1, 1];
+        /** 颈部: 慢启动，惯性停止 */
+        readonly neck: readonly [0.1, 0.2, 0.2, 1];
+        /** 全局: 标准 ease-in-out */
+        readonly global: readonly [0.42, 0, 0.58, 1];
+    };
+    readonly TIME_SCALE: {
+        /** 下颌: 40% 时间完成 (1/2.5) */
+        readonly jaw: 2.5;
+        /** 表情: 62.5% 时间完成 (1/1.6) */
+        readonly expression: 1.6;
+        /** 眼部: 77% 时间完成 (1/1.3) */
+        readonly eye: 1.3;
+        /** 颈部: 100% 时间完成 */
+        readonly neck: 1;
+        /** 全局: 100% 时间完成 */
+        readonly global: 1;
+    };
+};

package/dist/internal/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Internal Module - 统一常量和配置
+ *
+ * 与 Android SDK 保持一致的配置，方便跨平台维护
+ * @internal
+ */
+export {};

package/dist/types/index.d.ts

@@ -3,8 +3,7 @@
  */
 export declare enum Environment {
     cn = "cn",
-    intl = "intl",
-    test = "test"
+    intl = "intl"
 }
 export declare enum DrivingServiceMode {
     /** Driven by SDK directly */

package/dist/utils/animation-interpolation.d.ts

@@ -1,6 +1,8 @@
 /**
  * Animation Interpolation Utilities (SDK)
  * Layered interpolation with different timing for each facial component
- * Aligned with app implementation and iOS behavior
+ * Aligned with app implementation and iOS/Android behavior
+ *
+ * 贝塞尔曲线和时间缩放配置与 Android FlameFrameData.kt 保持一致
  */
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.76",
+  "version": "1.0.0-beta.78",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",
   "license": "MIT",