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

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.70] - 2026-01-17
+
+### 🔧 Improvements
+- **Code Cleanup** - Removed unused `FlatSplatData` interface from public API
+- **Internal Documentation** - Translated all internal code comments to English for consistency
+
 ## [1.0.0-beta.69] - 2026-01-17
 
 ### 🔧 Improvements

package/dist/{StreamingAudioPlayer-DiIRp5nx.js → StreamingAudioPlayer-Bi2685bX.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-BT9yxWW8.js";
+import { A as APP_CONFIG, l as logger, e as errorToMessage, a as logEvent } from "./index-CvW_c7G-.js";
 class StreamingAudioPlayer {
   // 标记是否正在恢复 AudioContext，避免并发恢复请求
   constructor(options) {

package/dist/config/app-config.d.ts

@@ -3,9 +3,9 @@ export declare const APP_CONFIG: {
     readonly debug: boolean;
     rendering: {
         /**
-         * 排序模式
-         * - 'balance': 性能优先，首帧排序后复用（默认）
-         * - 'quality': 质量优先，每帧重新排序
+         * Sort mode
+         * - 'balance': Performance first, sort first frame then reuse (default)
+         * - 'quality': Quality first, re-sort every frame
          */
         sortMode: "balance" | "quality";
     };

package/dist/config/sdk-config-loader.d.ts

@@ -1,15 +1,6 @@
-import { Environment } from '../types';
 /**
- * 默认 SDK 配置（当远程配置接口失败时使用）
+ * SDK configuration loader
+ * Fetch SDK endpoint configuration from remote config API
+ * @internal
  */
-export declare const DEFAULT_SDK_CONFIG: Partial<Record<Environment, string>>;
-/**
- * 从远程配置接口获取 SDK 配置
- * @param version SDK 版本号
- * @returns 解析后的配置映射
- */
-export declare function fetchSdkConfig(version: string): Promise<Partial<Record<Environment, string>>>;
-/**
- * 清除配置缓存（用于测试或重新加载）
- */
-export declare function clearSdkConfigCache(): void;
+export {};

package/dist/core/Avatar.d.ts

@@ -1,16 +1,8 @@
 import { CharacterMeta } from '../types';
-import { PreloadResult } from './AvatarDownloader';
 export declare class Avatar {
     readonly id: string;
     private characterMeta;
     private resources;
-    /**
-     * 构造函数（内部使用）
-     * @param id 数字人 ID
-     * @param characterMeta 角色元数据
-     * @param resources 资源数据
-     */
-    constructor(id: string, characterMeta: CharacterMeta, resources: PreloadResult);
     /**
      * Get character metadata
      * @returns Character metadata, including all configuration information (version, resource URLs, camera config, etc.)

package/dist/core/AvatarController.d.ts

@@ -63,11 +63,6 @@ export declare class AvatarController {
      * })
      */
     initializeAudioContext(): Promise<void>;
-    /**
-     * Check if audio context is initialized
-     * @throws AvatarError if audio context is not initialized
-     */
-    private checkAudioContextInitialized;
     /**
      * Start service (SDK mode only)
      */
@@ -130,26 +125,6 @@ export declare class AvatarController {
      * Clear all data and resources
      */
     clear(): void;
-    /**
-     * Generate new conversation ID and log conversation started event
-     * @private
-     */
-    private generateAndLogNewConversationId;
-    /**
-     * Clear playback data (keyframes, audio chunks, and playback state)
-     * @private
-     */
-    private clearPlaybackData;
-    /**
-     * Reset conversation ID state (for both network and external modes)
-     * @private
-     */
-    private resetConversationIdState;
-    /**
-     * Get effective conversation ID (handles both SDK and host modes)
-     * @private
-     */
-    private getEffectiveConversationId;
     /**
      * Get point cloud count of the current avatar
      * @returns Point cloud count, or null if avatar is not loaded
@@ -161,16 +136,6 @@ export declare class AvatarController {
      * @param config Post-processing configuration, or null to clear
      */
     setPostProcessingConfig(config: PostProcessingConfig | null): void;
-    /**
-     * 设置完整的 eye tracking 配置到 C++
-     * @private
-     */
-    private setEyeTrackingConfig;
-    /**
-     * 重新渲染当前帧（用于暂停状态下更新后处理参数）
-     * @private
-     */
-    private rerenderCurrentFrame;
     /**
      * Set audio playback volume
      * Note: This only controls the avatar audio player volume, not the system volume
@@ -182,33 +147,6 @@ export declare class AvatarController {
      * @returns Current volume value (0.0 - 1.0)
      */
     getVolume(): number;
-    /**
-     * Start streaming playback (internal implementation)
-     */
-    private startStreamingPlaybackInternal;
-    private startPlaybackLoop;
-    /**
-     * Stop playback loop
-     */
-    private stopPlaybackLoop;
-    /**
-     * 启用音频独立播放模式（当服务器错误或超时时调用）
-     * 此模式下，音频会独立播放，不依赖动画数据
-     * 一旦启用，本次会话后续的动画数据将被忽略
-     * @private
-     */
-    private enableAudioOnlyMode;
-    /**
-     * 音频独立播放（完全独立的逻辑，不影响正常播放流程）
-     * @private
-     */
-    private startAudioOnlyPlayback;
-    /**
-     * 音频监控循环（仅用于音频独立模式）
-     * 只检测音频是否结束，不进行动画渲染
-     * @private
-     */
-    private startAudioMonitoringLoop;
     /**
      * Stop playback
      */
@@ -217,28 +155,8 @@ export declare class AvatarController {
      * Clean up players
      */
     protected cleanupPlayers(): void;
-    /**
-     * Add audio chunk to buffer
-     * Note: animationPlayer should already be initialized before calling this method
-     */
-    private addAudioChunkToBuffer;
-    /**
-     * Event system
-     */
-    private registerEventListener;
     /**
      * Emit event
      */
     protected emit(event: string, data?: any): void;
-    /**
-     * Apply post-processing parameters to animation parameters
-     * @private
-     */
-    private applyPostProcessingToParams;
-    /**
-     * 上报 driving_service_latency 事件（Host 模式）
-     * 每轮会话只上报一次（在收到首帧时）
-     * @private
-     */
-    private reportDrivingServiceLatency;
 }

package/dist/core/AvatarManager.d.ts

@@ -18,14 +18,6 @@ export declare class AvatarManager {
      * @returns Promise<Avatar>
      */
     load(id: string, onProgress?: (progress: LoadProgressInfo) => void): Promise<Avatar>;
-    /**
-     * 处理下载队列（确保串行执行）
-     */
-    private processDownloadQueue;
-    /**
-     * 执行实际的加载逻辑（私有方法）
-     */
-    private doLoad;
     /**
      * Get cached avatar
      * @param id Avatar ID

package/dist/core/AvatarSDK.d.ts

@@ -11,15 +11,6 @@ export declare class AvatarSDK {
      * @param configuration Configuration parameters
      */
     static initialize(appId: string, configuration: Configuration): Promise<void>;
-    /**
-     * 初始化WASM模块（跟随整个SDK生命周期）
-     */
-    private static initializeWASMModule;
-    /**
-     * 初始化模板资源（在SDK初始化时加载）
-     * 从全局 CDN 加载模板资源，失败时直接抛出错误，阻止SDK初始化
-     */
-    private static initializeTemplateResources;
     /**
      * Set sessionToken
      * Developer Client -> Developer Server -> AvatarKit Server -> return sessionToken (max 1 hour validity)
@@ -41,8 +32,4 @@ export declare class AvatarSDK {
      * Cleanup resources
      */
     static cleanup(): void;
-    /**
-     * 从远程配置接口获取SDK配置（已简化，逻辑移到 config/sdk-config-loader.ts）
-     */
-    private static _fetchSdkConfig;
 }

package/dist/core/AvatarView.d.ts

@@ -32,22 +32,6 @@ export declare class AvatarView {
     private isPureRenderingMode;
     private avatarActiveTimer;
     private readonly AVATAR_ACTIVE_INTERVAL;
-    /**
-     * 对齐两端 Flame 维度：标量统一长度，expression 取最大长度并零填充
-     */
-    private alignFlamePair;
-    /**
-     * 生成并对齐过渡帧，确保首尾帧与起止帧完全一致
-     * @param from 起始帧
-     * @param to 目标帧
-     * @param durationMs 过渡时长（开头或结尾）
-     * @param useLinearInterpolation 是否使用线性插值（旧实现），true 用于 idle->speaking，false 用于 speaking->idle（使用 Bezier 曲线）
-     */
-    private generateAndAlignTransitionFrames;
-    /**
-     * 获取缓存的 Idle 首帧，如果未缓存则获取并缓存
-     */
-    private getCachedIdleFirstFrame;
     /**
      * Constructor
      * Creates a unified AvatarController, internally composes network layer based on configuration
@@ -59,105 +43,6 @@ export declare class AvatarView {
      * Get controller (public interface)
      */
     get controller(): AvatarController;
-    /**
-     * 创建canvas元素
-     */
-    private createCanvas;
-    /**
-     * 初始化视图系统
-     */
-    private initializeView;
-    /**
-     * 初始化渲染系统
-     */
-    private initializeRenderSystem;
-    /**
-     * 获取默认相机配置
-     */
-    private getDefaultCameraConfig;
-    /**
-     * 根据资源解析最终的相机配置，优先使用角色设置，其次 camera.json
-     */
-    private resolveCameraConfig;
-    /**
-     * 从角色设置中推导相机配置
-     */
-    private deriveCameraConfigFromSettings;
-    /**
-     * 渲染第一帧
-     */
-    private renderFirstFrame;
-    /**
-     * 更新 FPS 统计（在 requestAnimationFrame 回调中调用）
-     */
-    private updateFPS;
-    /**
-     * 初始化 FPS 计算
-     */
-    private initFPS;
-    /**
-     * 开始idle动画循环
-     */
-    private startIdleAnimationLoop;
-    /**
-     * 开始实时对话动画循环
-     */
-    private startRealtimeAnimationLoop;
-    /**
-     * 停止idle动画循环
-     */
-    private stopIdleAnimationLoop;
-    /**
-     * 停止实时对话动画循环
-     */
-    private stopRealtimeAnimationLoop;
-    /**
-     * 停止所有动画循环
-     */
-    private stopAllAnimationLoops;
-    /**
-     * 渲染实时帧（由播放层回调调用）
-     */
-    private renderRealtimeFrame;
-    /**
-     * 状态转换方法
-     * 统一管理状态转换，确保状态一致性
-     */
-    private setState;
-    /**
-     * 检查是否在实时播放状态（Speaking 或过渡到 Speaking）
-     */
-    private get isRealtimePlaying();
-    /**
-     * 检查是否在过渡中
-     */
-    private get isTransitioning();
-    /**
-     * 检查过渡结束后是否回到 Idle
-     */
-    private get endToIdleAfterTransition();
-    /**
-     * 处理打断
-     * 打断时应该生成过渡动画，而不是直接跳回 Idle
-     */
-    private handleInterrupt;
-    /**
-     * 设置 AvatarController 事件监听器
-     */
-    private setupControllerEventListeners;
-    /**
-     * 准备实时渲染（生成过渡到 Speaking）
-     * 统一逻辑：从当前正在播放的帧 -> Speaking 第一帧
-     */
-    private prepareRealtimeRendering;
-    /**
-     * 开始实时渲染循环
-     */
-    private startRealtimeRendering;
-    /**
-     * 停止实时对话渲染
-     */
-    private stopRealtimeRendering;
     /**
      * Cleanup view resources
      * Closes avatarController and cleans up all related resources
@@ -178,17 +63,6 @@ export declare class AvatarView {
      * @returns Transition frame array with length of frameCount
      */
     generateTransitionFromIdle(toKeyframeData: KeyframeData, frameCount: number, transitionType?: 'start' | 'end'): Promise<KeyframeData[]>;
-    /**
-     * 使用新的相机配置重新渲染当前帧（用于暂停状态下更新相机）
-     * 复用 AvatarController 的重新渲染逻辑，因为 renderCallback 会调用 renderRealtimeFrame，
-     * 而 renderRealtimeFrame 会使用已更新的相机配置（通过 renderSystem.updateCamera）
-     * @private
-     */
-    private rerenderCurrentFrameWithNewCamera;
-    /**
-     * 处理尺寸变化：通知渲染系统更新视口与投影
-     */
-    private handleResize;
     /**
      * Get or set avatar transform in canvas
      *
@@ -209,19 +83,4 @@ export declare class AvatarView {
         y: number;
         scale: number;
     });
-    /**
-     * 上报 avatar_active 埋点
-     * @private
-     */
-    private reportAvatarActive;
-    /**
-     * 启动 avatar_active 心跳埋点（每10分钟一次）
-     * @private
-     */
-    private startAvatarActiveHeartbeat;
-    /**
-     * 停止 avatar_active 心跳埋点
-     * @private
-     */
-    private stopAvatarActiveHeartbeat;
 }