@spatialwalk/avatarkit 1.0.0-beta.70 → 1.0.0-beta.71

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.71] - 2026-01-17
+
+### 🔧 Improvements
+- **Internal API** - Marked all audio and animation internal classes with `@internal` to prevent public API exposure
+- **Type Safety** - Hidden `AnimationPlayer`, `StreamingAudioPlayer`, `AnimationWebSocketClient`, and related utilities from public API
+- **Internal Documentation** - Fixed missing English translations in `AnimationWebSocketClient.ts`
+
 ## [1.0.0-beta.70] - 2026-01-17
 
 ### 🔧 Improvements

package/dist/{StreamingAudioPlayer-Bi2685bX.js → StreamingAudioPlayer-D8Q8WiEg.js}

@@ -1,9 +1,9 @@
 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-CvW_c7G-.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-U8QcNdma.js";
 class StreamingAudioPlayer {
-  // 标记是否正在恢复 AudioContext，避免并发恢复请求
+  // Mark if AudioContext is being resumed, avoid concurrent resume requests
   constructor(options) {
     // AudioContext is managed internally
     __publicField(this, "audioContext", null);
@@ -28,17 +28,17 @@ class StreamingAudioPlayer {
     __publicField(this, "autoStartEnabled", true);
     // Control whether to auto-start when buffer is ready
     __publicField(this, "autoContinue", false);
-    // 标记是否应该自动继续播放（当 end=false 且无数据时自动暂停后使用）
+    // Mark if should auto-continue playback (used after auto-pause when end=false and no data)
     // Audio buffer queue
     __publicField(this, "audioChunks", []);
     __publicField(this, "scheduledChunks", 0);
     // Number of chunks already scheduled
     __publicField(this, "activeSources", /* @__PURE__ */ new Set());
     __publicField(this, "lastScheduledChunkEndTime", 0);
-    // 最后一个已调度 chunk 的结束时间（相对时间）
+    // End time of last scheduled chunk (relative time)
     __publicField(this, "lastGetCurrentTimeLog", 0);
-    // 上次记录 getCurrentTime 日志的时间戳（用于节流）
-    // 跟踪每个已调度的 chunk 的开始时间（绝对时间）和持续时间，用于准确计算当前播放时间
+    // 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", []);
     // Volume control
     __publicField(this, "gainNode", null);
@@ -96,13 +96,14 @@ class StreamingAudioPlayer {
     }
   }
   /**
-   * 确保 AudioContext 正在运行（如果被暂停则自动恢复）
-   * 只在正在播放且未暂停时自动恢复，避免干扰正常的暂停/恢复逻辑
+   * Ensure AudioContext is running (auto-resume if suspended)
+   * Only auto-resume when playing and not paused, avoid interfering with normal pause/resume logic
    * 
-   * 优化：
-   * - 快速路径：如果已经是 running 状态，直接返回
-   * - 避免并发恢复：使用 isResuming 标志防止重复恢复请求
-   * - 处理 closed 状态：如果 AudioContext 已关闭，无法恢复
+   * Optimizations:
+   * - Fast path: if already in running state, return directly
+   * - Avoid concurrent resume: use isResuming flag to prevent duplicate resume requests
+   * - Handle closed state: if AudioContext is closed, cannot resume
+   * @internal
    */
   async ensureAudioContextRunning() {
     if (!this.audioContext) {
@@ -372,7 +373,8 @@ class StreamingAudioPlayer {
   }
   /**
    * Get current playback time (seconds)
-   * 返回实际播放的音频总时长
+   * Returns total actual playback duration
+   * @internal
    */
   getCurrentTime() {
     if (!this.audioContext || !this.isPlaying) {
@@ -403,7 +405,8 @@ class StreamingAudioPlayer {
   }
   /**
    * Get total duration of buffered audio (seconds)
-   * 计算所有已缓冲 chunk 的总时长
+   * Calculate total duration of all buffered chunks
+   * @internal
    */
   getBufferedDuration() {
     if (!this.audioContext) {
@@ -598,9 +601,10 @@ class StreamingAudioPlayer {
     this.log("Flushed (soft)", { remainingScheduled: this.scheduledChunks });
   }
   /**
-   * 设置音量 (0.0 - 1.0)
-   * 注意：这仅控制数字人音频播放器的音量，不影响系统音量
-   * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）
+   * Set volume (0.0 - 1.0)
+   * Note: This only controls avatar audio player volume, does not affect system volume
+   * @param volume Volume value, range 0.0 to 1.0 (0.0 is mute, 1.0 is max volume)
+   * @internal
    */
   setVolume(volume) {
     if (volume < 0 || volume > 1) {
@@ -613,8 +617,9 @@ class StreamingAudioPlayer {
     }
   }
   /**
-   * 获取当前音量
-   * @returns 当前音量值 (0.0 - 1.0)
+   * Get current volume
+   * @returns Current volume value (0.0 - 1.0)
+   * @internal
    */
   getVolume() {
     return this.volume;

package/dist/animation/AnimationWebSocketClient.d.ts

@@ -1,61 +1,6 @@
-import { EventEmitter } from './utils/eventEmitter';
-export interface AnimationWebSocketClientOptions {
-    wsUrl: string;
-    reconnectAttempts?: number;
-    jwtToken?: string;
-    appId?: string;
-    clientId?: string;
-}
-export declare class AnimationWebSocketClient extends EventEmitter {
-    private wsUrl;
-    private reconnectAttempts;
-    private jwtToken?;
-    private appId?;
-    private clientId?;
-    private ws;
-    private currentCharacterId;
-    private currentRetryCount;
-    private isConnecting;
-    private isManuallyDisconnected;
-    private reconnectTimer;
-    private sessionConfigured;
-    constructor(options: AnimationWebSocketClientOptions);
-    /**
-     * 连接WebSocket
-     */
-    connect(characterId: string): Promise<void>;
-    /**
-     * 断开连接
-     */
-    disconnect(): void;
-    /**
-     * 发送音频数据
-     * @param conversationId - 会话ID（在 protobuf 协议中映射为 reqId 字段）
-     */
-    sendAudioData(conversationId: string, audioData: ArrayBuffer, end: boolean): boolean;
-    /**
-     * 生成会话ID
-     * 使用统一的会话ID生成规则：YYYYMMDDHHmmss_nanoid
-     */
-    generateConversationId(): string;
-    /**
-     * 获取连接状态
-     */
-    isConnected(): boolean;
-    /**
-     * 获取当前角色ID
-     */
-    getCurrentCharacterId(): string;
-    private buildWebSocketUrl;
-    private connectWebSocket;
-    /**
-     * 清理 URL 用于日志记录（隐藏敏感信息）
-     */
-    private sanitizeUrlForLog;
-    /**
-     * v2 协议：配置会话（发送采样率等参数）
-     */
-    private configureSession;
-    private handleMessage;
-    private scheduleReconnect;
-}
+/**
+ * AnimationWebSocketClient: Animation-specific WebSocket client
+ * Uses driveningress/v2 protocol, only handles audio input and animation output
+ * @internal
+ */
+export {};

package/dist/animation/utils/eventEmitter.d.ts

@@ -1,12 +1,5 @@
 /**
  * Simple Event Emitter
+ * @internal
  */
-type EventHandler = (...args: any[]) => void;
-export declare class EventEmitter {
-    private events;
-    on(event: string, handler: EventHandler): void;
-    off(event: string, handler: EventHandler): void;
-    emit(event: string, ...args: any[]): void;
-    removeAllListeners(event?: string): void;
-}
 export {};

package/dist/animation/utils/flameConverter.d.ts

@@ -1,25 +1,5 @@
-import { Flame } from '../../generated/driveningress/v1/driveningress';
-export interface FlameParams {
-    shape_params?: number[];
-    expr_params?: number[];
-    rotation?: number[];
-    translation?: number[];
-    neck_pose?: number[];
-    jaw_pose?: number[];
-    eyes_pose?: number[];
-    eyelid?: number[];
-    has_eyelid?: boolean;
-}
 /**
- * Convert proto Flame to WASM FlameParams format
+ * Convert proto Flame to WASM FlameParams
+ * @internal
  */
-export declare function convertProtoFlameToWasmParams(protoFlame: Flame): FlameParams;
-/**
- * Convert WASM FlameParams to proto Flame format
- * Used for transition animation from idle to speaking
- */
-export declare function convertWasmParamsToProtoFlame(wasmParams: FlameParams): Flame;
-/**
- * Create a neutral proto Flame (zero pose)
- */
-export declare function createNeutralFlameProto(): Flame;
+export {};

package/dist/audio/AnimationPlayer.d.ts

@@ -1,75 +1,6 @@
-import { StreamingAudioPlayer } from './StreamingAudioPlayer';
-export declare class AnimationPlayer {
-    private audio;
-    private streamingPlayer;
-    private _isPlaying;
-    private fps;
-    private onEndedCallback?;
-    private static audioUnlocked;
-    private useStreaming;
-    /**
-     * 解锁音频上下文（Safari 自动播放策略）
-     * 必须在用户交互事件（如 click）中调用
-     */
-    static unlockAudioContext(): Promise<void>;
-    /**
-     * Initialize with HTMLAudioElement (traditional way)
-     */
-    initialize(audioUrl: string, onEnded?: () => void): Promise<void>;
-    /**
-     * Initialize with StreamingAudioPlayer (streaming way)
-     * @deprecated 使用 prepareStreamingPlayer() 代替
-     */
-    initializeStreaming(streamingPlayer: StreamingAudioPlayer, onEnded?: () => void): Promise<void>;
-    /**
-     * 检查流式播放器是否已准备好
-     */
-    isStreamingReady(): boolean;
-    /**
-     * 获取流式播放器实例
-     */
-    getStreamingPlayer(): StreamingAudioPlayer | null;
-    /**
-     * 创建并初始化流式播放器
-     * 在服务连接建立时调用
-     */
-    createAndInitializeStreamingPlayer(): Promise<void>;
-    /**
-     * 准备流式播放器（如果未创建则创建并初始化）
-     * 停止之前的播放并更新结束回调
-     */
-    prepareStreamingPlayer(onEnded?: () => void): Promise<void>;
-    private setupEventListeners;
-    play(): Promise<void>;
-    stop(): void;
-    isPlaying(): boolean;
-    getCurrentFrameIndex(): number;
-    /**
-     * Get current playback time
-     */
-    getCurrentTime(): number;
-    /**
-     * 添加音频块（仅用于流式播放）
-     */
-    addAudioChunk(audio: Uint8Array, isLast?: boolean): void;
-    /**
-     * 暂停播放
-     */
-    pause(): void;
-    /**
-     * 继续播放
-     */
-    resume(): Promise<void>;
-    /**
-     * 设置音量 (0.0 - 1.0)
-     * 注意：这仅控制数字人音频播放器的音量，不影响系统音量
-     * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）
-     */
-    setVolume(volume: number): void;
-    /**
-     * 获取当前音量
-     * @returns 当前音量值 (0.0 - 1.0)
-     */
-    getVolume(): number;
-    dispose(): void;
-}
+/**
+ * Audio-animation synchronized player
+ * Supports HTMLAudioElement (traditional) and StreamingAudioPlayer (streaming)
+ * @internal
+ */
+export {};

package/dist/audio/StreamingAudioPlayer.d.ts

@@ -2,154 +2,6 @@
  * Streaming Audio Player
  * Implements real-time audio playback using Web Audio API
  * Supports dynamic PCM chunk addition without Workers
+ * @internal
  */
-export interface StreamingAudioPlayerOptions {
-    sampleRate?: number;
-    channelCount?: number;
-    debug?: boolean;
-}
-export declare class StreamingAudioPlayer {
-    private audioContext;
-    private sampleRate;
-    private channelCount;
-    private debug;
-    private sessionId;
-    private sessionStartTime;
-    private pausedTimeOffset;
-    private pausedAt;
-    private pausedAudioContextTime;
-    private scheduledTime;
-    private isPlaying;
-    private isPaused;
-    private autoStartEnabled;
-    private autoContinue;
-    private audioChunks;
-    private scheduledChunks;
-    private activeSources;
-    private lastScheduledChunkEndTime;
-    private lastGetCurrentTimeLog;
-    private scheduledChunkInfo;
-    private gainNode;
-    private volume;
-    private onEndedCallback?;
-    private stateChangeHandler?;
-    private isResuming;
-    constructor(options?: StreamingAudioPlayerOptions);
-    /**
-     * Initialize audio context (create and ensure it's ready)
-     */
-    initialize(): Promise<void>;
-    /**
-     * 确保 AudioContext 正在运行（如果被暂停则自动恢复）
-     * 只在正在播放且未暂停时自动恢复，避免干扰正常的暂停/恢复逻辑
-     *
-     * 优化：
-     * - 快速路径：如果已经是 running 状态，直接返回
-     * - 避免并发恢复：使用 isResuming 标志防止重复恢复请求
-     * - 处理 closed 状态：如果 AudioContext 已关闭，无法恢复
-     */
-    private ensureAudioContextRunning;
-    /**
-     * Add audio chunk (16-bit PCM)
-     */
-    addChunk(pcmData: Uint8Array, isLast?: boolean): void;
-    /**
-     * Start new session (stop current and start fresh)
-     */
-    startNewSession(audioChunks: Array<{
-        data: Uint8Array;
-        isLast: boolean;
-    }>): Promise<void>;
-    /**
-     * Start playback
-     */
-    private startPlayback;
-    /**
-     * Schedule all pending chunks
-     */
-    private scheduleAllChunks;
-    /**
-     * Schedule next audio chunk
-     */
-    private scheduleNextChunk;
-    /**
-     * Convert PCM data to AudioBuffer
-     * Input: 16-bit PCM (int16), Output: AudioBuffer (float32 [-1, 1])
-     */
-    private pcmToAudioBuffer;
-    /**
-     * Get current playback time (seconds)
-     * 返回实际播放的音频总时长
-     */
-    getCurrentTime(): number;
-    /**
-     * Get total duration of buffered audio (seconds)
-     * 计算所有已缓冲 chunk 的总时长
-     */
-    getBufferedDuration(): number;
-    /**
-     * Get current AudioContext time
-     * @returns Current AudioContext time in seconds, or 0 if AudioContext is not initialized
-     */
-    getAudioContextTime(): number;
-    /**
-     * Pause playback
-     */
-    pause(): void;
-    /**
-     * Resume playback
-     */
-    resume(): Promise<void>;
-    /**
-     * Stop playback
-     */
-    stop(): void;
-    /**
-     * Enable or disable auto-start (for delayed start scenarios)
-     */
-    setAutoStart(enabled: boolean): void;
-    /**
-     * Start playback manually (for delayed start scenarios)
-     * This allows starting playback after transition animation completes
-     */
-    play(): void;
-    /**
-     * Mark playback as ended
-     */
-    markEnded(): void;
-    /**
-     * Set ended callback
-     */
-    onEnded(callback: () => void): void;
-    /**
-     * Check if playing
-     */
-    isPlayingNow(): boolean;
-    /**
-     * Dispose and cleanup
-     */
-    dispose(): void;
-    /**
-     * Flush buffered audio
-     * - hard: stops all playing sources and clears all chunks
-     * - soft (default): clears UNSCHEDULED chunks only
-     */
-    flush(options?: {
-        hard?: boolean;
-    }): void;
-    /**
-     * 设置音量 (0.0 - 1.0)
-     * 注意：这仅控制数字人音频播放器的音量，不影响系统音量
-     * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）
-     */
-    setVolume(volume: number): void;
-    /**
-     * 获取当前音量
-     * @returns 当前音量值 (0.0 - 1.0)
-     */
-    getVolume(): number;
-    /**
-     * Debug logging
-     */
-    private log;
-}
+export {};

package/dist/{index-CvW_c7G-.js → index-U8QcNdma.js}

@@ -7780,8 +7780,9 @@ const _AnimationPlayer = class _AnimationPlayer {
     __publicField(this, "useStreaming", false);
   }
   /**
-   * 解锁音频上下文（Safari 自动播放策略）
-   * 必须在用户交互事件（如 click）中调用
+   * Unlock audio context (Safari autoplay policy)
+   * Must be called in user interaction event (e.g., click)
+   * @internal
    */
   static async unlockAudioContext() {
     if (_AnimationPlayer.audioUnlocked) {
@@ -7802,6 +7803,9 @@ const _AnimationPlayer = class _AnimationPlayer {
   }
   /**
    * Initialize with HTMLAudioElement (traditional way)
+   * @param audioUrl Audio file URL
+   * @param onEnded Optional callback when playback ends
+   * @internal
    */
   async initialize(audioUrl, onEnded) {
     this.onEndedCallback = onEnded;
@@ -7820,7 +7824,8 @@ const _AnimationPlayer = class _AnimationPlayer {
   }
   /**
    * Initialize with StreamingAudioPlayer (streaming way)
-   * @deprecated 使用 prepareStreamingPlayer() 代替
+   * @deprecated Use prepareStreamingPlayer() instead
+   * @internal
    */
   async initializeStreaming(streamingPlayer, onEnded) {
     this.streamingPlayer = streamingPlayer;
@@ -7833,26 +7838,29 @@ const _AnimationPlayer = class _AnimationPlayer {
     });
   }
   /**
-   * 检查流式播放器是否已准备好
+   * Check if streaming player is ready
+   * @internal
    */
   isStreamingReady() {
     return this.useStreaming && this.streamingPlayer !== null;
   }
   /**
-   * 获取流式播放器实例
+   * Get streaming player instance
+   * @internal
    */
   getStreamingPlayer() {
     return this.streamingPlayer;
   }
   /**
-   * 创建并初始化流式播放器
-   * 在服务连接建立时调用
+   * Create and initialize streaming player
+   * Called when service connection is established
+   * @internal
    */
   async createAndInitializeStreamingPlayer() {
     if (this.streamingPlayer) {
       return;
     }
-    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-Bi2685bX.js");
+    const { StreamingAudioPlayer } = await import("./StreamingAudioPlayer-D8Q8WiEg.js");
     const { AvatarSDK: AvatarSDK2 } = await Promise.resolve().then(() => AvatarSDK$1);
     const audioFormat = AvatarSDK2.getAudioFormat();
     this.streamingPlayer = new StreamingAudioPlayer({
@@ -7874,8 +7882,9 @@ const _AnimationPlayer = class _AnimationPlayer {
     this.useStreaming = true;
   }
   /**
-   * 准备流式播放器（如果未创建则创建并初始化）
-   * 停止之前的播放并更新结束回调
+   * Prepare streaming player (create and initialize if not created)
+   * Stop previous playback and update end callback
+   * @internal
    */
   async prepareStreamingPlayer(onEnded) {
     if (!this.streamingPlayer) {
@@ -7904,6 +7913,10 @@ const _AnimationPlayer = class _AnimationPlayer {
       (_a = this.onEndedCallback) == null ? void 0 : _a.call(this);
     });
   }
+  /**
+   * Start playback
+   * @internal
+   */
   async play() {
     if (this.useStreaming) {
       this._isPlaying = true;
@@ -7914,6 +7927,10 @@ const _AnimationPlayer = class _AnimationPlayer {
       await this.audio.play();
     }
   }
+  /**
+   * Stop playback
+   * @internal
+   */
   stop() {
     var _a;
     this._isPlaying = false;
@@ -7926,6 +7943,10 @@ const _AnimationPlayer = class _AnimationPlayer {
       }
     }
   }
+  /**
+   * Check if currently playing
+   * @internal
+   */
   isPlaying() {
     var _a;
     if (this.useStreaming) {
@@ -7933,12 +7954,17 @@ const _AnimationPlayer = class _AnimationPlayer {
     }
     return this._isPlaying;
   }
+  /**
+   * Get current frame index
+   * @internal
+   */
   getCurrentFrameIndex() {
     const currentTime = this.getCurrentTime();
     return Math.floor(currentTime * this.fps);
   }
   /**
    * Get current playback time
+   * @internal
    */
   getCurrentTime() {
     var _a, _b;
@@ -7948,7 +7974,8 @@ const _AnimationPlayer = class _AnimationPlayer {
     return ((_b = this.audio) == null ? void 0 : _b.currentTime) ?? 0;
   }
   /**
-   * 添加音频块（仅用于流式播放）
+   * Add audio chunk (only for streaming playback)
+   * @internal
    */
   addAudioChunk(audio, isLast = false) {
     if (this.useStreaming && this.streamingPlayer) {
@@ -7958,7 +7985,8 @@ const _AnimationPlayer = class _AnimationPlayer {
     }
   }
   /**
-   * 暂停播放
+   * Pause playback
+   * @internal
    */
   pause() {
     var _a;
@@ -7971,7 +7999,8 @@ const _AnimationPlayer = class _AnimationPlayer {
     }
   }
   /**
-   * 继续播放
+   * Resume playback
+   * @internal
    */
   async resume() {
     var _a;
@@ -7984,9 +8013,10 @@ const _AnimationPlayer = class _AnimationPlayer {
     }
   }
   /**
-   * 设置音量 (0.0 - 1.0)
-   * 注意：这仅控制数字人音频播放器的音量，不影响系统音量
-   * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）
+   * Set volume (0.0 - 1.0)
+   * Note: This only controls avatar audio player volume, does not affect system volume
+   * @param volume Volume value, range 0.0 to 1.0 (0.0 is mute, 1.0 is max volume)
+   * @internal
    */
   setVolume(volume) {
     if (this.useStreaming && this.streamingPlayer) {
@@ -7998,8 +8028,9 @@ const _AnimationPlayer = class _AnimationPlayer {
     }
   }
   /**
-   * 获取当前音量
-   * @returns 当前音量值 (0.0 - 1.0)
+   * Get current volume
+   * @returns Current volume value (0.0 - 1.0)
+   * @internal
    */
   getVolume() {
     var _a;
@@ -8009,6 +8040,10 @@ const _AnimationPlayer = class _AnimationPlayer {
       return ((_a = this.audio) == null ? void 0 : _a.volume) ?? 1;
     }
   }
+  /**
+   * Dispose and cleanup
+   * @internal
+   */
   dispose() {
     this.stop();
     if (this.audio) {
@@ -9496,7 +9531,7 @@ class AvatarSDK {
 }
 __publicField(AvatarSDK, "_isInitialized", false);
 __publicField(AvatarSDK, "_configuration", null);
-__publicField(AvatarSDK, "_version", "1.0.0-beta.70");
+__publicField(AvatarSDK, "_version", "1.0.0-beta.71");
 __publicField(AvatarSDK, "_avatarCore", null);
 __publicField(AvatarSDK, "_dynamicSdkConfig", null);
 const AvatarSDK$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
@@ -10487,7 +10522,7 @@ class EventEmitter {
   }
 }
 class AnimationWebSocketClient extends EventEmitter {
-  // v2 协议：标记会话是否已配置
+  // v2 protocol: mark if session is configured
   constructor(options) {
     super();
     __publicField(this, "wsUrl");
@@ -10509,7 +10544,8 @@ class AnimationWebSocketClient extends EventEmitter {
     this.clientId = options.clientId;
   }
   /**
-   * 连接WebSocket
+   * Connect WebSocket
+   * @internal
    */
   async connect(characterId) {
     if (this.ws && this.ws.readyState === WebSocket.OPEN) {
@@ -10537,7 +10573,8 @@ class AnimationWebSocketClient extends EventEmitter {
     }
   }
   /**
-   * 断开连接
+   * Disconnect
+   * @internal
    */
   disconnect() {
     if (this.ws) {
@@ -10557,8 +10594,9 @@ class AnimationWebSocketClient extends EventEmitter {
     logger.log("[AnimationWebSocketClient] Disconnected");
   }
   /**
-   * 发送音频数据
-   * @param conversationId - 会话ID（在 protobuf 协议中映射为 reqId 字段）
+   * Send audio data
+   * @param conversationId - Conversation ID (mapped to reqId field in protobuf protocol)
+   * @internal
    */
   sendAudioData(conversationId, audioData, end) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
@@ -10596,25 +10634,28 @@ class AnimationWebSocketClient extends EventEmitter {
     }
   }
   /**
-   * 生成会话ID
-   * 使用统一的会话ID生成规则：YYYYMMDDHHmmss_nanoid
+   * Generate conversation ID
+   * Uses unified conversation ID generation rule: YYYYMMDDHHmmss_nanoid
+   * @internal
    */
   generateConversationId() {
     return idManager.generateNewConversationId();
   }
   /**
-   * 获取连接状态
+   * Get connection state
+   * @internal
    */
   isConnected() {
     return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
   }
   /**
-   * 获取当前角色ID
+   * Get current character ID
+   * @internal
    */
   getCurrentCharacterId() {
     return this.currentCharacterId;
   }
-  // ========== 私有方法 ==========
+  // ========== Private Methods ==========
   buildWebSocketUrl(characterId) {
     const url = new URL(this.wsUrl);
     url.searchParams.set("id", characterId);
@@ -10742,7 +10783,8 @@ class AnimationWebSocketClient extends EventEmitter {
     });
   }
   /**
-   * 清理 URL 用于日志记录（隐藏敏感信息）
+   * Sanitize URL for logging (hide sensitive information)
+   * @internal
    */
   sanitizeUrlForLog(url) {
     try {
@@ -10761,7 +10803,8 @@ class AnimationWebSocketClient extends EventEmitter {
     }
   }
   /**
-   * v2 协议：配置会话（发送采样率等参数）
+   * v2 protocol: configure session (send sample rate and other parameters)
+   * @internal
    */
   configureSession() {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
@@ -10775,7 +10818,7 @@ class AnimationWebSocketClient extends EventEmitter {
         clientConfigureSession: {
           sampleRate: audioFormatConfig.sampleRate,
           bitrate: 0,
-          // 根据实际需求设置
+          // Set according to actual requirements
           audioFormat: AudioFormat.AUDIO_FORMAT_PCM_S16LE,
           transportCompression: TransportCompression.TRANSPORT_COMPRESSION_NONE
         }

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-CvW_c7G-.js";
+import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-U8QcNdma.js";
 export {
   b as Avatar,
   c as AvatarController,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.70",
+  "version": "1.0.0-beta.71",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",