@spatialwalk/avatarkit 1.0.0-beta.10 → 1.0.0-beta.12

package/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.12] - 2025-11-17
+
+### 🔒 API Improvements
+- Marked performance monitoring APIs as internal
+  - `RenderPerformanceStats` interface and `getPerformanceStats()` method are now marked with `@internal` tag
+  - These APIs are not exposed in the public TypeScript definitions
+  - Reverted performance monitoring implementation to simpler version (only `renderTime` and `sortTime`)
+
+---
+
+## [1.0.0-beta.11] - 2025-11-17
+
+### 📚 Documentation
+- Updated demo repository link in README.md
+  - Changed example project link from `Avatarkit-web-demo` to `AvatarKit-Web-Demo` to match the new repository name
+
+---
+
 ## [1.0.0-beta.10] - 2025-11-16
 
 ### 🔒 API Improvements

package/README.md

@@ -96,7 +96,7 @@ avatarView.avatarController.sendKeyframes(animationData2)
 
 Check the example code in the GitHub repository for complete usage flows for both modes.
 
-**Example Project:** [Avatarkit-web-demo](https://github.com/spatialwalk/Avatarkit-web-demo)
+**Example Project:** [AvatarKit-Web-Demo](https://github.com/spatialwalk/AvatarKit-Web-Demo)
 
 This repository contains complete examples for Vanilla JS, Vue 3, and React, demonstrating:
 - Network mode: Real-time audio input with automatic animation data reception
@@ -110,7 +110,7 @@ The SDK uses a three-layer architecture for clear separation of concerns:
 
 1. **Rendering Layer (AvatarView)** - Responsible for 3D rendering only
 2. **Playback Layer (AvatarController)** - Manages audio/animation synchronization and playback
-3. **Network Layer (NetworkLayer)** - Handles WebSocket communication (only in network mode)
+3. **Network Layer** - Handles WebSocket communication (only in network mode, internal implementation)
 
 ### Core Components
 
@@ -118,8 +118,6 @@ The SDK uses a three-layer architecture for clear separation of concerns:
 - **AvatarManager** - Character resource loading and management
 - **AvatarView** - 3D rendering view (rendering layer)
 - **AvatarController** - Audio/animation playback controller (playback layer)
-- **NetworkLayer** - WebSocket communication (network layer, automatically composed in network mode)
-- **AvatarCoreAdapter** - WASM module adapter
 
 ### Playback Modes
 
@@ -146,11 +144,11 @@ User audio input (16kHz mono PCM16)
     ↓
 AvatarController.send() 
     ↓
-NetworkLayer → WebSocket → Backend processing
+WebSocket → Backend processing
     ↓
 Backend returns animation data (FLAME keyframes) 
     ↓
-NetworkLayer → AvatarController → AnimationPlayer
+AvatarController → AnimationPlayer
     ↓
 FLAME parameters → AvatarCore.computeFrameFlatFromParams() → Splat data
     ↓
@@ -316,7 +314,7 @@ if (currentAvatarView.playbackMode === AvatarPlaybackMode.network) {
 
 ### AvatarController
 
-Audio/animation playback controller (playback layer), manages synchronized playback of audio and animation. Automatically composes `NetworkLayer` in network mode.
+Audio/animation playback controller (playback layer), manages synchronized playback of audio and animation. Automatically handles WebSocket communication in network mode.
 
 **Two Usage Patterns:**
 
@@ -472,57 +470,6 @@ The SDK supports two rendering backends:
 
 The rendering system automatically selects the best backend, no manual configuration needed.
 
-## 🔍 Debugging and Monitoring
-
-### Logging System
-
-The SDK has a built-in complete logging system, supporting different levels of log output:
-
-```typescript
-import { logger } from '@spatialwalk/avatarkit'
-
-// Set log level
-logger.setLevel('verbose') // 'basic' | 'verbose'
-
-// Manual log output
-logger.log('Info message')
-logger.warn('Warning message')
-logger.error('Error message')
-```
-
-### Performance Monitoring
-
-The SDK provides performance monitoring interfaces to monitor rendering performance:
-
-```typescript
-// Get rendering performance statistics
-const stats = avatarView.getPerformanceStats()
-
-if (stats) {
-  console.log(`Render time: ${stats.renderTime.toFixed(2)}ms`)
-  console.log(`Sort time: ${stats.sortTime.toFixed(2)}ms`)
-  console.log(`Rendering backend: ${stats.backend}`)
-  
-  // Calculate frame rate
-  const fps = 1000 / stats.renderTime
-  console.log(`Frame rate: ${fps.toFixed(2)} FPS`)
-}
-
-// Regular performance monitoring
-setInterval(() => {
-  const stats = avatarView.getPerformanceStats()
-  if (stats) {
-    // Send to monitoring service or display on UI
-    console.log('Performance:', stats)
-  }
-}, 1000)
-```
-
-**Performance Statistics Description:**
-- `renderTime`: Total rendering time (milliseconds), includes sorting and GPU rendering
-- `sortTime`: Sorting time (milliseconds), uses Radix Sort algorithm to depth-sort point cloud
-- `backend`: Currently used rendering backend (`'webgpu'` | `'webgl'` | `null`)
-
 ## 🚨 Error Handling
 
 ### SPAvatarError

package/dist/{StreamingAudioPlayer-Bq2-bQiT.js → StreamingAudioPlayer-BT7Qa8Ow.js}

@@ -1,7 +1,7 @@
 var g = Object.defineProperty;
 var f = (h, t, e) => t in h ? g(h, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : h[t] = e;
 var i = (h, t, e) => f(h, typeof t != "symbol" ? t + "" : t, e);
-import { A as C, e as m, a as c, l as r } from "./index-bQnEVIkT.js";
+import { A as C, e as m, a as c, l as r } from "./index-CDG7huUa.js";
 class A {
   constructor(t) {
     // AudioContext is managed internally
@@ -316,4 +316,4 @@ class A {
 export {
   A as StreamingAudioPlayer
 };
-//# sourceMappingURL=StreamingAudioPlayer-Bq2-bQiT.js.map
+//# sourceMappingURL=StreamingAudioPlayer-BT7Qa8Ow.js.map

package/dist/{StreamingAudioPlayer-Bq2-bQiT.js.map → StreamingAudioPlayer-BT7Qa8Ow.js.map}

@@ -1 +1 @@
-{"version":3,"file":"StreamingAudioPlayer-Bq2-bQiT.js","sources":["../audio/StreamingAudioPlayer.ts"],"sourcesContent":["/**\n * Streaming Audio Player\n * Implements real-time audio playback using Web Audio API\n * Supports dynamic PCM chunk addition without Workers\n */\n\nimport { APP_CONFIG } from '../config/app-config'\nimport { AvatarKit } from '../core/AvatarKit'\nimport { errorToMessage } from '../utils/error-utils'\nimport { logger } from '../utils/logger'\n\nexport interface StreamingAudioPlayerOptions {\n  sampleRate?: number // PCM sample rate (default: APP_CONFIG.audio.sampleRate, backend requires 16kHz)\n  channelCount?: number // Number of channels (default: 1)\n  debug?: boolean\n}\n\nexport class StreamingAudioPlayer {\n  // AudioContext is managed internally\n  private audioContext: AudioContext | null = null\n  private sampleRate: number\n  private channelCount: number\n  private debug: boolean\n\n  // Session-level state\n  private sessionId: string\n  private sessionStartTime = 0 // AudioContext time when session started\n  private pausedTimeOffset = 0 // Accumulated paused time\n  private pausedAt = 0 // Time when paused\n  private scheduledTime = 0 // Next chunk schedule time in AudioContext time\n\n  // Playback state\n  private isPlaying = false\n  private isPaused = false\n  private autoStartEnabled = true // Control whether to auto-start when buffer is ready\n\n  // Audio buffer queue\n  private audioChunks: Array<{ data: Uint8Array, isLast: boolean }> = []\n  private scheduledChunks = 0 // Number of chunks already scheduled\n  private activeSources: AudioBufferSourceNode[] = []\n\n  // Event callbacks\n  private onEndedCallback?: () => void\n\n  constructor(options?: StreamingAudioPlayerOptions) {\n    this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`\n    this.sampleRate = options?.sampleRate ?? APP_CONFIG.audio.sampleRate\n    this.channelCount = options?.channelCount ?? 1\n    this.debug = options?.debug ?? false\n  }\n\n  /**\n   * Initialize audio context (create and ensure it's ready)\n   */\n  async initialize(): Promise<void> {\n    if (this.audioContext) {\n      return\n    }\n\n    try {\n      // Create AudioContext\n      this.audioContext = new AudioContext({\n        sampleRate: this.sampleRate,\n      })\n\n      // Resume context (required for some browsers)\n      if (this.audioContext.state === 'suspended') {\n        await this.audioContext.resume()\n      }\n\n      this.log('AudioContext initialized', {\n        sessionId: this.sessionId,\n        sampleRate: this.audioContext.sampleRate,\n        state: this.audioContext.state,\n      })\n    }\n    catch (error) {\n      const message = errorToMessage(error)\n      AvatarKit.logEvent('activeAudioSessionFailed', 'warning', {\n        sessionId: this.sessionId,\n        reason: message,\n      })\n      logger.error('Failed to initialize AudioContext:', message)\n      throw error instanceof Error ? error : new Error(message)\n    }\n  }\n\n  /**\n   * Add audio chunk (16-bit PCM)\n   */\n  addChunk(pcmData: Uint8Array, isLast: boolean = false): void {\n    if (!this.audioContext) {\n      logger.error('AudioContext not initialized')\n      return\n    }\n\n    // Store chunk with metadata\n    this.audioChunks.push({ data: pcmData, isLast })\n\n    // Track buffer underrun warning\n    if (this.isPlaying && this.audioChunks.length === this.scheduledChunks) {\n      // Buffer underrun detected - chunks consumed faster than added\n    }\n\n    this.log(`Added chunk ${this.audioChunks.length}`, {\n      size: pcmData.length,\n      totalChunks: this.audioChunks.length,\n      isLast,\n      isPlaying: this.isPlaying,\n      scheduledChunks: this.scheduledChunks,\n    })\n\n    // Auto-start if we have any audio chunks and auto-start is enabled\n    if (!this.isPlaying && this.autoStartEnabled && this.audioChunks.length > 0) {\n      this.log('[StreamingAudioPlayer] Auto-starting playback from addChunk')\n      this.startPlayback()\n    }\n    // Schedule next chunk if already playing\n    else if (this.isPlaying) {\n      this.log('[StreamingAudioPlayer] Already playing, scheduling next chunk')\n      this.scheduleNextChunk()\n    } else {\n      this.log('[StreamingAudioPlayer] Not playing and no chunks, waiting for more chunks')\n    }\n  }\n\n  /**\n   * Start new session (stop current and start fresh)\n   */\n  async startNewSession(audioChunks: Array<{ data: Uint8Array, isLast: boolean }>): Promise<void> {\n    // Stop current session if playing\n    this.stop()\n\n    // Generate new session ID to prevent data mixing\n    this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`\n\n    // Reset session state\n    this.audioChunks = []\n    this.scheduledChunks = 0\n    this.pausedTimeOffset = 0\n    this.pausedAt = 0\n    // Don't set sessionStartTime or scheduledTime here - let startPlayback() set them\n    this.log('Starting new session', {\n      chunks: audioChunks.length,\n    })\n\n    // Add audio chunks with their metadata\n    for (const chunk of audioChunks) {\n      this.addChunk(chunk.data, chunk.isLast)\n    }\n  }\n\n  /**\n   * Start playback\n   */\n  private startPlayback(): void {\n    if (!this.audioContext) {\n      this.log('[StreamingAudioPlayer] Cannot start playback: AudioContext not initialized')\n      return\n    }\n    if (this.isPlaying) {\n      this.log('[StreamingAudioPlayer] Cannot start playback: Already playing')\n      return\n    }\n\n    this.isPlaying = true\n    this.sessionStartTime = this.audioContext.currentTime\n    this.scheduledTime = this.sessionStartTime\n\n    this.log('[StreamingAudioPlayer] Starting playback', {\n      sessionStartTime: this.sessionStartTime,\n      bufferedChunks: this.audioChunks.length,\n      scheduledChunks: this.scheduledChunks,\n      activeSources: this.activeSources.length,\n    })\n\n    // Schedule all available chunks\n    this.scheduleAllChunks()\n  }\n\n  /**\n   * Schedule all pending chunks\n   */\n  private scheduleAllChunks(): void {\n    while (this.scheduledChunks < this.audioChunks.length) {\n      this.scheduleNextChunk()\n    }\n  }\n\n  /**\n   * Schedule next audio chunk\n   */\n  private scheduleNextChunk(): void {\n    if (!this.audioContext) {\n      this.log('[StreamingAudioPlayer] Cannot schedule chunk: AudioContext not initialized')\n      return\n    }\n    if (!this.isPlaying) {\n      this.log('[StreamingAudioPlayer] Cannot schedule chunk: Not playing')\n      return\n    }\n\n    const chunkIndex = this.scheduledChunks\n    if (chunkIndex >= this.audioChunks.length) {\n      this.log(`[StreamingAudioPlayer] No more chunks to schedule (chunkIndex: ${chunkIndex}, totalChunks: ${this.audioChunks.length})`)\n      return\n    }\n\n    const chunk = this.audioChunks[chunkIndex]\n\n    // 当音频块为空且不是最后一个块时，跳过调度\n    if (chunk.data.length === 0 && !chunk.isLast) {\n      this.scheduledChunks++\n      return\n    }\n\n    const pcmData = chunk.data\n    const isLast = chunk.isLast\n    const audioBuffer = this.pcmToAudioBuffer(pcmData)\n\n    if (!audioBuffer) {\n      const errorMessage = 'Failed to create AudioBuffer from PCM data'\n      logger.error(errorMessage)\n      AvatarKit.logEvent('character_player', 'error', {\n        sessionId: this.sessionId,\n        event: 'audio_buffer_creation_failed',\n      })\n      return\n    }\n\n    try {\n      // Create and configure source node\n      const source = this.audioContext.createBufferSource()\n      source.buffer = audioBuffer\n      source.connect(this.audioContext.destination)\n\n      // Schedule playback\n      source.start(this.scheduledTime)\n\n      // Track active source for hard-cancel\n      this.activeSources.push(source)\n      source.onended = () => {\n        // Remove from active list when it ends\n        const idx = this.activeSources.indexOf(source)\n        if (idx >= 0)\n          this.activeSources.splice(idx, 1)\n\n        // Check if this was the last chunk and all sources have ended\n        if (isLast && this.activeSources.length === 0) {\n          this.log('Last audio chunk ended, marking playback as ended')\n          this.markEnded()\n        }\n      }\n\n      // Update scheduled time for next chunk\n      this.scheduledTime += audioBuffer.duration\n\n      this.scheduledChunks++\n\n      this.log(`[StreamingAudioPlayer] Scheduled chunk ${chunkIndex + 1}/${this.audioChunks.length}`, {\n        startTime: this.scheduledTime - audioBuffer.duration,\n        duration: audioBuffer.duration,\n        nextScheduleTime: this.scheduledTime,\n        isLast,\n        activeSources: this.activeSources.length,\n      })\n    }\n    catch (err) {\n      logger.errorWithError('Failed to schedule audio chunk:', err)\n      AvatarKit.logEvent('character_player', 'error', {\n        sessionId: this.sessionId,\n        event: 'schedule_chunk_failed',\n        reason: err instanceof Error ? err.message : String(err),\n      })\n    }\n  }\n\n  /**\n   * Convert PCM data to AudioBuffer\n   * Input: 16-bit PCM (int16), Output: AudioBuffer (float32 [-1, 1])\n   */\n  private pcmToAudioBuffer(pcmData: Uint8Array): AudioBuffer | null {\n    if (!this.audioContext) {\n      return null\n    }\n\n    // Handle empty PCM data (e.g., when isLast is true)\n    if (pcmData.length === 0) {\n      // For empty chunks (typically the last chunk), create minimal silence\n      // Use a very short duration to avoid playback stuttering\n      const silenceDuration = 0.01 // 1ms - minimal silence to maintain timing\n      const numSamples = Math.floor(this.sampleRate * silenceDuration)\n\n      const audioBuffer = this.audioContext.createBuffer(\n        this.channelCount,\n        numSamples,\n        this.sampleRate,\n      )\n\n      // Fill with silence (all zeros)\n      for (let channel = 0; channel < this.channelCount; channel++) {\n        const channelData = audioBuffer.getChannelData(channel)\n        channelData.fill(0) // Fill with silence\n      }\n\n      return audioBuffer\n    }\n\n    // Create aligned copy to avoid byte offset issues\n    // Int16Array requires byteOffset to be a multiple of 2\n    const alignedData = new Uint8Array(pcmData)\n    const int16Array = new Int16Array(alignedData.buffer, 0, alignedData.length / 2)\n\n    // Calculate number of samples\n    const numSamples = int16Array.length / this.channelCount\n\n    // Create AudioBuffer\n    const audioBuffer = this.audioContext.createBuffer(\n      this.channelCount,\n      numSamples,\n      this.sampleRate,\n    )\n\n    // Convert int16 to float32 [-1, 1]\n    for (let channel = 0; channel < this.channelCount; channel++) {\n      const channelData = audioBuffer.getChannelData(channel)\n\n      for (let i = 0; i < numSamples; i++) {\n        const sampleIndex = i * this.channelCount + channel\n        // Normalize int16 (-32768 to 32767) to float32 (-1 to 1)\n        channelData[i] = int16Array[sampleIndex] / 32768.0\n      }\n    }\n\n    return audioBuffer\n  }\n\n  /**\n   * Get current playback time (seconds)\n   */\n  getCurrentTime(): number {\n    if (!this.audioContext || !this.isPlaying) {\n      return 0\n    }\n\n    if (this.isPaused) {\n      return this.pausedAt\n    }\n\n    // Calculate elapsed time using session start time and paused offset\n    const currentAudioTime = this.audioContext.currentTime\n    const elapsed = currentAudioTime - this.sessionStartTime - this.pausedTimeOffset\n\n    return Math.max(0, elapsed)\n  }\n\n  /**\n   * Pause playback\n   */\n  pause(): void {\n    if (!this.isPlaying || this.isPaused) {\n      return\n    }\n\n    this.isPaused = true\n    this.pausedAt = this.getCurrentTime()\n\n    // Don't suspend AudioContext to maintain time continuity\n    // Just mark as paused and stop scheduling new chunks\n    this.log('Playback paused', {\n      pausedAt: this.pausedAt,\n    })\n  }\n\n  /**\n   * Resume playback\n   */\n  async resume(): Promise<void> {\n    if (!this.isPaused || !this.audioContext) {\n      return\n    }\n\n    // Calculate paused duration and add to offset\n    const pauseDuration = this.audioContext.currentTime - (this.sessionStartTime + this.pausedAt)\n    this.pausedTimeOffset += pauseDuration\n\n    this.isPaused = false\n\n    this.log('Playback resumed', {\n      pauseDuration,\n      totalPausedOffset: this.pausedTimeOffset,\n    })\n  }\n\n  /**\n   * Stop playback\n   */\n  stop(): void {\n    if (!this.audioContext) {\n      return\n    }\n\n    this.isPlaying = false\n    this.isPaused = false\n    this.sessionStartTime = 0 // Reset session start time\n    this.scheduledTime = 0 // Reset scheduled time for next session\n\n    // Hard stop all scheduled sources immediately\n    for (const source of this.activeSources) {\n      source.onended = null\n      try {\n        source.stop(0)\n      }\n      catch {}\n      try {\n        source.disconnect()\n      }\n      catch {}\n    }\n    this.activeSources = []\n\n    // 清理音频块和调度状态，确保下次播放时状态干净\n    this.audioChunks = []\n    this.scheduledChunks = 0\n\n    this.log('[StreamingAudioPlayer] Playback stopped, state reset')\n\n    // Note: Individual source nodes will stop automatically\n    // We just reset our state\n  }\n\n  /**\n   * Enable or disable auto-start (for delayed start scenarios)\n   */\n  setAutoStart(enabled: boolean): void {\n    this.autoStartEnabled = enabled\n    this.log(`Auto-start ${enabled ? 'enabled' : 'disabled'}`)\n  }\n\n  /**\n   * Start playback manually (for delayed start scenarios)\n   * This allows starting playback after transition animation completes\n   */\n  play(): void {\n    if (this.isPlaying) {\n      return\n    }\n    // Enable auto-start when manually starting playback\n    this.autoStartEnabled = true\n    this.startPlayback()\n  }\n\n  /**\n   * Mark playback as ended\n   */\n  markEnded(): void {\n    this.log('Playback ended')\n    this.isPlaying = false\n    this.onEndedCallback?.()\n  }\n\n  /**\n   * Set ended callback\n   */\n  onEnded(callback: () => void): void {\n    this.onEndedCallback = callback\n  }\n\n  /**\n   * Check if playing\n   */\n  isPlayingNow(): boolean {\n    return this.isPlaying && !this.isPaused\n  }\n\n  /**\n   * Get total duration of buffered audio\n   */\n  getBufferedDuration(): number {\n    if (!this.audioContext) {\n      return 0\n    }\n\n    let totalSamples = 0\n    for (const chunk of this.audioChunks) {\n      totalSamples += chunk.data.length / 2 / this.channelCount // 16-bit = 2 bytes per sample\n    }\n\n    return totalSamples / this.sampleRate\n  }\n\n  /**\n   * Get remaining duration (buffered - played) in seconds\n   */\n  getRemainingDuration(): number {\n    const total = this.getBufferedDuration()\n    const played = this.getCurrentTime()\n    return Math.max(0, total - played)\n  }\n\n\n  /**\n   * Dispose and cleanup\n   */\n  dispose(): void {\n    this.stop()\n\n    // Close AudioContext\n    if (this.audioContext) {\n      this.audioContext.close()\n      this.audioContext = null\n    }\n\n    // Clear session state\n    this.audioChunks = []\n    this.scheduledChunks = 0\n    this.sessionStartTime = 0\n    this.pausedTimeOffset = 0\n    this.pausedAt = 0\n    this.scheduledTime = 0\n    this.onEndedCallback = undefined\n\n    this.log('StreamingAudioPlayer disposed')\n  }\n\n  /**\n   * Flush buffered audio\n   * - hard: stops all playing sources and clears all chunks\n   * - soft (default): clears UNSCHEDULED chunks only\n   */\n  flush(options?: { hard?: boolean }): void {\n    const hard = options?.hard === true\n    if (hard) {\n      this.stop()\n      this.audioChunks = []\n      this.scheduledChunks = 0\n      this.sessionStartTime = 0\n      this.pausedAt = 0\n      this.scheduledTime = 0\n      this.log('Flushed (hard)')\n      return\n    }\n\n    // Soft flush: drop unscheduled region\n    if (this.scheduledChunks < this.audioChunks.length) {\n      this.audioChunks.splice(this.scheduledChunks)\n    }\n    this.log('Flushed (soft)', { remainingScheduled: this.scheduledChunks })\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(message: string, data?: unknown): void {\n    if (this.debug) {\n      logger.log(`[StreamingAudioPlayer] ${message}`, data || '')\n    }\n  }\n}\n"],"names":["StreamingAudioPlayer","options","__publicField","APP_CONFIG","error","message","errorToMessage","AvatarKit","logger","pcmData","isLast","audioChunks","chunk","chunkIndex","audioBuffer","source","idx","err","numSamples","channel","alignedData","int16Array","channelData","i","sampleIndex","elapsed","pauseDuration","enabled","_a","callback","totalSamples","total","played","data"],"mappings":"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"}
+{"version":3,"file":"StreamingAudioPlayer-BT7Qa8Ow.js","sources":["../audio/StreamingAudioPlayer.ts"],"sourcesContent":["/**\n * Streaming Audio Player\n * Implements real-time audio playback using Web Audio API\n * Supports dynamic PCM chunk addition without Workers\n */\n\nimport { APP_CONFIG } from '../config/app-config'\nimport { AvatarKit } from '../core/AvatarKit'\nimport { errorToMessage } from '../utils/error-utils'\nimport { logger } from '../utils/logger'\n\nexport interface StreamingAudioPlayerOptions {\n  sampleRate?: number // PCM sample rate (default: APP_CONFIG.audio.sampleRate, backend requires 16kHz)\n  channelCount?: number // Number of channels (default: 1)\n  debug?: boolean\n}\n\nexport class StreamingAudioPlayer {\n  // AudioContext is managed internally\n  private audioContext: AudioContext | null = null\n  private sampleRate: number\n  private channelCount: number\n  private debug: boolean\n\n  // Session-level state\n  private sessionId: string\n  private sessionStartTime = 0 // AudioContext time when session started\n  private pausedTimeOffset = 0 // Accumulated paused time\n  private pausedAt = 0 // Time when paused\n  private scheduledTime = 0 // Next chunk schedule time in AudioContext time\n\n  // Playback state\n  private isPlaying = false\n  private isPaused = false\n  private autoStartEnabled = true // Control whether to auto-start when buffer is ready\n\n  // Audio buffer queue\n  private audioChunks: Array<{ data: Uint8Array, isLast: boolean }> = []\n  private scheduledChunks = 0 // Number of chunks already scheduled\n  private activeSources: AudioBufferSourceNode[] = []\n\n  // Event callbacks\n  private onEndedCallback?: () => void\n\n  constructor(options?: StreamingAudioPlayerOptions) {\n    this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`\n    this.sampleRate = options?.sampleRate ?? APP_CONFIG.audio.sampleRate\n    this.channelCount = options?.channelCount ?? 1\n    this.debug = options?.debug ?? false\n  }\n\n  /**\n   * Initialize audio context (create and ensure it's ready)\n   */\n  async initialize(): Promise<void> {\n    if (this.audioContext) {\n      return\n    }\n\n    try {\n      // Create AudioContext\n      this.audioContext = new AudioContext({\n        sampleRate: this.sampleRate,\n      })\n\n      // Resume context (required for some browsers)\n      if (this.audioContext.state === 'suspended') {\n        await this.audioContext.resume()\n      }\n\n      this.log('AudioContext initialized', {\n        sessionId: this.sessionId,\n        sampleRate: this.audioContext.sampleRate,\n        state: this.audioContext.state,\n      })\n    }\n    catch (error) {\n      const message = errorToMessage(error)\n      AvatarKit.logEvent('activeAudioSessionFailed', 'warning', {\n        sessionId: this.sessionId,\n        reason: message,\n      })\n      logger.error('Failed to initialize AudioContext:', message)\n      throw error instanceof Error ? error : new Error(message)\n    }\n  }\n\n  /**\n   * Add audio chunk (16-bit PCM)\n   */\n  addChunk(pcmData: Uint8Array, isLast: boolean = false): void {\n    if (!this.audioContext) {\n      logger.error('AudioContext not initialized')\n      return\n    }\n\n    // Store chunk with metadata\n    this.audioChunks.push({ data: pcmData, isLast })\n\n    // Track buffer underrun warning\n    if (this.isPlaying && this.audioChunks.length === this.scheduledChunks) {\n      // Buffer underrun detected - chunks consumed faster than added\n    }\n\n    this.log(`Added chunk ${this.audioChunks.length}`, {\n      size: pcmData.length,\n      totalChunks: this.audioChunks.length,\n      isLast,\n      isPlaying: this.isPlaying,\n      scheduledChunks: this.scheduledChunks,\n    })\n\n    // Auto-start if we have any audio chunks and auto-start is enabled\n    if (!this.isPlaying && this.autoStartEnabled && this.audioChunks.length > 0) {\n      this.log('[StreamingAudioPlayer] Auto-starting playback from addChunk')\n      this.startPlayback()\n    }\n    // Schedule next chunk if already playing\n    else if (this.isPlaying) {\n      this.log('[StreamingAudioPlayer] Already playing, scheduling next chunk')\n      this.scheduleNextChunk()\n    } else {\n      this.log('[StreamingAudioPlayer] Not playing and no chunks, waiting for more chunks')\n    }\n  }\n\n  /**\n   * Start new session (stop current and start fresh)\n   */\n  async startNewSession(audioChunks: Array<{ data: Uint8Array, isLast: boolean }>): Promise<void> {\n    // Stop current session if playing\n    this.stop()\n\n    // Generate new session ID to prevent data mixing\n    this.sessionId = `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`\n\n    // Reset session state\n    this.audioChunks = []\n    this.scheduledChunks = 0\n    this.pausedTimeOffset = 0\n    this.pausedAt = 0\n    // Don't set sessionStartTime or scheduledTime here - let startPlayback() set them\n    this.log('Starting new session', {\n      chunks: audioChunks.length,\n    })\n\n    // Add audio chunks with their metadata\n    for (const chunk of audioChunks) {\n      this.addChunk(chunk.data, chunk.isLast)\n    }\n  }\n\n  /**\n   * Start playback\n   */\n  private startPlayback(): void {\n    if (!this.audioContext) {\n      this.log('[StreamingAudioPlayer] Cannot start playback: AudioContext not initialized')\n      return\n    }\n    if (this.isPlaying) {\n      this.log('[StreamingAudioPlayer] Cannot start playback: Already playing')\n      return\n    }\n\n    this.isPlaying = true\n    this.sessionStartTime = this.audioContext.currentTime\n    this.scheduledTime = this.sessionStartTime\n\n    this.log('[StreamingAudioPlayer] Starting playback', {\n      sessionStartTime: this.sessionStartTime,\n      bufferedChunks: this.audioChunks.length,\n      scheduledChunks: this.scheduledChunks,\n      activeSources: this.activeSources.length,\n    })\n\n    // Schedule all available chunks\n    this.scheduleAllChunks()\n  }\n\n  /**\n   * Schedule all pending chunks\n   */\n  private scheduleAllChunks(): void {\n    while (this.scheduledChunks < this.audioChunks.length) {\n      this.scheduleNextChunk()\n    }\n  }\n\n  /**\n   * Schedule next audio chunk\n   */\n  private scheduleNextChunk(): void {\n    if (!this.audioContext) {\n      this.log('[StreamingAudioPlayer] Cannot schedule chunk: AudioContext not initialized')\n      return\n    }\n    if (!this.isPlaying) {\n      this.log('[StreamingAudioPlayer] Cannot schedule chunk: Not playing')\n      return\n    }\n\n    const chunkIndex = this.scheduledChunks\n    if (chunkIndex >= this.audioChunks.length) {\n      this.log(`[StreamingAudioPlayer] No more chunks to schedule (chunkIndex: ${chunkIndex}, totalChunks: ${this.audioChunks.length})`)\n      return\n    }\n\n    const chunk = this.audioChunks[chunkIndex]\n\n    // 当音频块为空且不是最后一个块时，跳过调度\n    if (chunk.data.length === 0 && !chunk.isLast) {\n      this.scheduledChunks++\n      return\n    }\n\n    const pcmData = chunk.data\n    const isLast = chunk.isLast\n    const audioBuffer = this.pcmToAudioBuffer(pcmData)\n\n    if (!audioBuffer) {\n      const errorMessage = 'Failed to create AudioBuffer from PCM data'\n      logger.error(errorMessage)\n      AvatarKit.logEvent('character_player', 'error', {\n        sessionId: this.sessionId,\n        event: 'audio_buffer_creation_failed',\n      })\n      return\n    }\n\n    try {\n      // Create and configure source node\n      const source = this.audioContext.createBufferSource()\n      source.buffer = audioBuffer\n      source.connect(this.audioContext.destination)\n\n      // Schedule playback\n      source.start(this.scheduledTime)\n\n      // Track active source for hard-cancel\n      this.activeSources.push(source)\n      source.onended = () => {\n        // Remove from active list when it ends\n        const idx = this.activeSources.indexOf(source)\n        if (idx >= 0)\n          this.activeSources.splice(idx, 1)\n\n        // Check if this was the last chunk and all sources have ended\n        if (isLast && this.activeSources.length === 0) {\n          this.log('Last audio chunk ended, marking playback as ended')\n          this.markEnded()\n        }\n      }\n\n      // Update scheduled time for next chunk\n      this.scheduledTime += audioBuffer.duration\n\n      this.scheduledChunks++\n\n      this.log(`[StreamingAudioPlayer] Scheduled chunk ${chunkIndex + 1}/${this.audioChunks.length}`, {\n        startTime: this.scheduledTime - audioBuffer.duration,\n        duration: audioBuffer.duration,\n        nextScheduleTime: this.scheduledTime,\n        isLast,\n        activeSources: this.activeSources.length,\n      })\n    }\n    catch (err) {\n      logger.errorWithError('Failed to schedule audio chunk:', err)\n      AvatarKit.logEvent('character_player', 'error', {\n        sessionId: this.sessionId,\n        event: 'schedule_chunk_failed',\n        reason: err instanceof Error ? err.message : String(err),\n      })\n    }\n  }\n\n  /**\n   * Convert PCM data to AudioBuffer\n   * Input: 16-bit PCM (int16), Output: AudioBuffer (float32 [-1, 1])\n   */\n  private pcmToAudioBuffer(pcmData: Uint8Array): AudioBuffer | null {\n    if (!this.audioContext) {\n      return null\n    }\n\n    // Handle empty PCM data (e.g., when isLast is true)\n    if (pcmData.length === 0) {\n      // For empty chunks (typically the last chunk), create minimal silence\n      // Use a very short duration to avoid playback stuttering\n      const silenceDuration = 0.01 // 1ms - minimal silence to maintain timing\n      const numSamples = Math.floor(this.sampleRate * silenceDuration)\n\n      const audioBuffer = this.audioContext.createBuffer(\n        this.channelCount,\n        numSamples,\n        this.sampleRate,\n      )\n\n      // Fill with silence (all zeros)\n      for (let channel = 0; channel < this.channelCount; channel++) {\n        const channelData = audioBuffer.getChannelData(channel)\n        channelData.fill(0) // Fill with silence\n      }\n\n      return audioBuffer\n    }\n\n    // Create aligned copy to avoid byte offset issues\n    // Int16Array requires byteOffset to be a multiple of 2\n    const alignedData = new Uint8Array(pcmData)\n    const int16Array = new Int16Array(alignedData.buffer, 0, alignedData.length / 2)\n\n    // Calculate number of samples\n    const numSamples = int16Array.length / this.channelCount\n\n    // Create AudioBuffer\n    const audioBuffer = this.audioContext.createBuffer(\n      this.channelCount,\n      numSamples,\n      this.sampleRate,\n    )\n\n    // Convert int16 to float32 [-1, 1]\n    for (let channel = 0; channel < this.channelCount; channel++) {\n      const channelData = audioBuffer.getChannelData(channel)\n\n      for (let i = 0; i < numSamples; i++) {\n        const sampleIndex = i * this.channelCount + channel\n        // Normalize int16 (-32768 to 32767) to float32 (-1 to 1)\n        channelData[i] = int16Array[sampleIndex] / 32768.0\n      }\n    }\n\n    return audioBuffer\n  }\n\n  /**\n   * Get current playback time (seconds)\n   */\n  getCurrentTime(): number {\n    if (!this.audioContext || !this.isPlaying) {\n      return 0\n    }\n\n    if (this.isPaused) {\n      return this.pausedAt\n    }\n\n    // Calculate elapsed time using session start time and paused offset\n    const currentAudioTime = this.audioContext.currentTime\n    const elapsed = currentAudioTime - this.sessionStartTime - this.pausedTimeOffset\n\n    return Math.max(0, elapsed)\n  }\n\n  /**\n   * Pause playback\n   */\n  pause(): void {\n    if (!this.isPlaying || this.isPaused) {\n      return\n    }\n\n    this.isPaused = true\n    this.pausedAt = this.getCurrentTime()\n\n    // Don't suspend AudioContext to maintain time continuity\n    // Just mark as paused and stop scheduling new chunks\n    this.log('Playback paused', {\n      pausedAt: this.pausedAt,\n    })\n  }\n\n  /**\n   * Resume playback\n   */\n  async resume(): Promise<void> {\n    if (!this.isPaused || !this.audioContext) {\n      return\n    }\n\n    // Calculate paused duration and add to offset\n    const pauseDuration = this.audioContext.currentTime - (this.sessionStartTime + this.pausedAt)\n    this.pausedTimeOffset += pauseDuration\n\n    this.isPaused = false\n\n    this.log('Playback resumed', {\n      pauseDuration,\n      totalPausedOffset: this.pausedTimeOffset,\n    })\n  }\n\n  /**\n   * Stop playback\n   */\n  stop(): void {\n    if (!this.audioContext) {\n      return\n    }\n\n    this.isPlaying = false\n    this.isPaused = false\n    this.sessionStartTime = 0 // Reset session start time\n    this.scheduledTime = 0 // Reset scheduled time for next session\n\n    // Hard stop all scheduled sources immediately\n    for (const source of this.activeSources) {\n      source.onended = null\n      try {\n        source.stop(0)\n      }\n      catch {}\n      try {\n        source.disconnect()\n      }\n      catch {}\n    }\n    this.activeSources = []\n\n    // 清理音频块和调度状态，确保下次播放时状态干净\n    this.audioChunks = []\n    this.scheduledChunks = 0\n\n    this.log('[StreamingAudioPlayer] Playback stopped, state reset')\n\n    // Note: Individual source nodes will stop automatically\n    // We just reset our state\n  }\n\n  /**\n   * Enable or disable auto-start (for delayed start scenarios)\n   */\n  setAutoStart(enabled: boolean): void {\n    this.autoStartEnabled = enabled\n    this.log(`Auto-start ${enabled ? 'enabled' : 'disabled'}`)\n  }\n\n  /**\n   * Start playback manually (for delayed start scenarios)\n   * This allows starting playback after transition animation completes\n   */\n  play(): void {\n    if (this.isPlaying) {\n      return\n    }\n    // Enable auto-start when manually starting playback\n    this.autoStartEnabled = true\n    this.startPlayback()\n  }\n\n  /**\n   * Mark playback as ended\n   */\n  markEnded(): void {\n    this.log('Playback ended')\n    this.isPlaying = false\n    this.onEndedCallback?.()\n  }\n\n  /**\n   * Set ended callback\n   */\n  onEnded(callback: () => void): void {\n    this.onEndedCallback = callback\n  }\n\n  /**\n   * Check if playing\n   */\n  isPlayingNow(): boolean {\n    return this.isPlaying && !this.isPaused\n  }\n\n  /**\n   * Get total duration of buffered audio\n   */\n  getBufferedDuration(): number {\n    if (!this.audioContext) {\n      return 0\n    }\n\n    let totalSamples = 0\n    for (const chunk of this.audioChunks) {\n      totalSamples += chunk.data.length / 2 / this.channelCount // 16-bit = 2 bytes per sample\n    }\n\n    return totalSamples / this.sampleRate\n  }\n\n  /**\n   * Get remaining duration (buffered - played) in seconds\n   */\n  getRemainingDuration(): number {\n    const total = this.getBufferedDuration()\n    const played = this.getCurrentTime()\n    return Math.max(0, total - played)\n  }\n\n\n  /**\n   * Dispose and cleanup\n   */\n  dispose(): void {\n    this.stop()\n\n    // Close AudioContext\n    if (this.audioContext) {\n      this.audioContext.close()\n      this.audioContext = null\n    }\n\n    // Clear session state\n    this.audioChunks = []\n    this.scheduledChunks = 0\n    this.sessionStartTime = 0\n    this.pausedTimeOffset = 0\n    this.pausedAt = 0\n    this.scheduledTime = 0\n    this.onEndedCallback = undefined\n\n    this.log('StreamingAudioPlayer disposed')\n  }\n\n  /**\n   * Flush buffered audio\n   * - hard: stops all playing sources and clears all chunks\n   * - soft (default): clears UNSCHEDULED chunks only\n   */\n  flush(options?: { hard?: boolean }): void {\n    const hard = options?.hard === true\n    if (hard) {\n      this.stop()\n      this.audioChunks = []\n      this.scheduledChunks = 0\n      this.sessionStartTime = 0\n      this.pausedAt = 0\n      this.scheduledTime = 0\n      this.log('Flushed (hard)')\n      return\n    }\n\n    // Soft flush: drop unscheduled region\n    if (this.scheduledChunks < this.audioChunks.length) {\n      this.audioChunks.splice(this.scheduledChunks)\n    }\n    this.log('Flushed (soft)', { remainingScheduled: this.scheduledChunks })\n  }\n\n  /**\n   * Debug logging\n   */\n  private log(message: string, data?: unknown): void {\n    if (this.debug) {\n      logger.log(`[StreamingAudioPlayer] ${message}`, data || '')\n    }\n  }\n}\n"],"names":["StreamingAudioPlayer","options","__publicField","APP_CONFIG","error","message","errorToMessage","AvatarKit","logger","pcmData","isLast","audioChunks","chunk","chunkIndex","audioBuffer","source","idx","err","numSamples","channel","alignedData","int16Array","channelData","i","sampleIndex","elapsed","pauseDuration","enabled","_a","callback","totalSamples","total","played","data"],"mappings":"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"}

package/dist/core/AvatarView.d.ts

@@ -1,4 +1,4 @@
-import { RenderPerformanceStats, AvatarViewOptions, AvatarPlaybackMode } from '../types';
+import { AvatarViewOptions, AvatarPlaybackMode } from '../types';
 import { Avatar } from './Avatar';
 import { AvatarController } from './AvatarController';
 export declare class AvatarView {
@@ -150,10 +150,5 @@ export declare class AvatarView {
      * 处理尺寸变化：通知渲染系统更新视口与投影
      */
     private handleResize;
-    /**
-     * 获取渲染性能统计
-     * @returns 渲染性能统计数据，如果渲染系统未初始化则返回 null
-     */
-    getPerformanceStats(): RenderPerformanceStats | null;
 }
 //# sourceMappingURL=AvatarView.d.ts.map

package/dist/core/AvatarView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarView.d.ts","sourceRoot":"","sources":["../../core/AvatarView.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAgB,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAI7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAQtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAYrD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,SAAgB,YAAY,EAAE,kBAAkB,CAAA;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAG/B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,YAAY,CAA4B;IAGhD,OAAO,CAAC,cAAc,CAAsC;IAG5D,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,sBAAsB,CAAa;IAC3C,OAAO,CAAC,sBAAsB,CAAqB;IAGnD,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,uBAAuB,CAAsB;IACrD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,mBAAmB,CAAc;IACzC,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAc;IACnD,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,qBAAqB,CAAY;IAEzC;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAoBxC;;OAEG;YACW,uBAAuB;IAgBrC;;;OAGG;gBAED,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB;IAgC7B;;OAEG;IACH,IAAI,UAAU,IAAI,gBAAgB,CAEjC;IAED;;OAEG;IACH,OAAO,CAAC,YAAY;IA6EpB;;OAEG;YACW,cAAc;IAmD5B;;OAEG;YACW,sBAAsB;IAwBpC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IA2EtC;;OAEG;YACW,gBAAgB;IAsC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsE9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAsFlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAwBhB;;OAEG;IACH,OAAO,KAAK,iBAAiB,GAG5B;IAED;;OAEG;IACH,OAAO,KAAK,eAAe,GAG1B;IAED;;OAEG;IACH,OAAO,KAAK,wBAAwB,GAEnC;IAED;;;OAGG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;OAEG;YACW,wBAAwB;IA4DtC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8D7B;;;OAGG;IACH,OAAO,IAAI,IAAI;IAwFf;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,mBAAmB,IAAI,sBAAsB,GAAG,IAAI;CAarD"}
+{"version":3,"file":"AvatarView.d.ts","sourceRoot":"","sources":["../../core/AvatarView.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAwC,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAI7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAQtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAYrD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,SAAgB,YAAY,EAAE,kBAAkB,CAAA;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAG/B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,YAAY,CAA4B;IAGhD,OAAO,CAAC,cAAc,CAAsC;IAG5D,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,sBAAsB,CAAa;IAC3C,OAAO,CAAC,sBAAsB,CAAqB;IAGnD,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,uBAAuB,CAAsB;IACrD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,mBAAmB,CAAc;IACzC,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAc;IACnD,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,qBAAqB,CAAY;IAEzC;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAoBxC;;OAEG;YACW,uBAAuB;IAgBrC;;;OAGG;gBAED,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB;IAgC7B;;OAEG;IACH,IAAI,UAAU,IAAI,gBAAgB,CAEjC;IAED;;OAEG;IACH,OAAO,CAAC,YAAY;IA6EpB;;OAEG;YACW,cAAc;IAmD5B;;OAEG;YACW,sBAAsB;IAwBpC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,8BAA8B;IA2EtC;;OAEG;YACW,gBAAgB;IAsC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsE9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAsFlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAwBhB;;OAEG;IACH,OAAO,KAAK,iBAAiB,GAG5B;IAED;;OAEG;IACH,OAAO,KAAK,eAAe,GAG1B;IAED;;OAEG;IACH,OAAO,KAAK,wBAAwB,GAEnC;IAED;;;OAGG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;OAEG;YACW,wBAAwB;IA4DtC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8D7B;;;OAGG;IACH,OAAO,IAAI,IAAI;IAwFf;;OAEG;IACH,OAAO,CAAC,YAAY;CAwBrB"}

package/dist/core/NetworkLayer.d.ts

@@ -1,59 +1,8 @@
-import { AvatarController } from './AvatarController';
-export declare class NetworkLayer {
-    private wsClient;
-    private dataController;
-    private currentReqId;
-    private hasSentEnd;
-    private readonly audioBytesPerSecond;
-    private audioMetrics;
-    constructor(dataController: AvatarController);
-    /**
-     * 连接服务
-     */
-    connect(characterId: string): Promise<void>;
-    /**
-     * 发送音频数据到服务器
-     */
-    sendAudioData(audioData: ArrayBuffer, isLast: boolean): void;
-    /**
-     * 断开连接
-     */
-    disconnect(): void;
-    /**
-     * 获取当前请求ID
-     */
-    getCurrentReqId(): string | null;
-    /**
-     * 重置请求ID（用于打断后清理）
-     */
-    resetReqId(): void;
-    /**
-     * 设置 WebSocket 事件监听器
-     */
-    private setupWebSocketListeners;
-    /**
-     * 处理接收到的消息
-     */
-    private handleMessage;
-    /**
-     * 处理动画消息
-     */
-    private handleAnimationMessage;
-    /**
-     * 处理错误消息
-     */
-    private handleErrorMessage;
-    /**
-     * 创建音频指标
-     */
-    private createAudioMetrics;
-    /**
-     * 重置音频指标
-     */
-    private resetAudioMetrics;
-    /**
-     * 上报音频指标
-     */
-    private reportAudioMetrics;
-}
+/**
+ * NetworkLayer - Network communication layer
+ * Responsible for WebSocket connections, protocol handling, and data retrieval
+ * Automatically calls AvatarController (playback layer) interfaces after obtaining data
+ * @internal Not part of public API
+ */
+export {};
 //# sourceMappingURL=NetworkLayer.d.ts.map

package/dist/core/NetworkLayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkLayer.d.ts","sourceRoot":"","sources":["../../core/NetworkLayer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAsB1D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,YAAY,CAA0C;gBAElD,cAAc,EAAE,gBAAgB;IAgB5C;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAyE5D;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA2C/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4C1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAc3B"}
+{"version":3,"file":"NetworkLayer.d.ts","sourceRoot":"","sources":["../../core/NetworkLayer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/{index-bQnEVIkT.js → index-CDG7huUa.js}

@@ -1940,7 +1940,7 @@ class b {
     h[a](`[Telemetry] ${e}`, i);
   }
 }
-d(b, "_isInitialized", !1), d(b, "_appId", null), d(b, "_configuration", null), d(b, "_sessionToken", null), d(b, "_userId", null), d(b, "_version", "1.0.0-beta.10"), d(b, "_avatarCore", null), d(b, "_dynamicSdkConfig", null), d(b, "_logLevels", {
+d(b, "_isInitialized", !1), d(b, "_appId", null), d(b, "_configuration", null), d(b, "_sessionToken", null), d(b, "_userId", null), d(b, "_version", "1.0.0-beta.12"), d(b, "_avatarCore", null), d(b, "_dynamicSdkConfig", null), d(b, "_logLevels", {
   debug: "log",
   info: "log",
   warning: "warn",
@@ -2009,7 +2009,7 @@ const Ce = class Ce {
   async createAndInitializeStreamingPlayer() {
     if (this.streamingPlayer)
       return;
-    const { StreamingAudioPlayer: e } = await import("./StreamingAudioPlayer-Bq2-bQiT.js");
+    const { StreamingAudioPlayer: e } = await import("./StreamingAudioPlayer-BT7Qa8Ow.js");
     this.streamingPlayer = new e({
       sampleRate: k.audio.sampleRate,
       channelCount: 1,
@@ -5207,9 +5207,9 @@ class Mi {
     d(this, "backend", null);
     d(this, "canvas");
     d(this, "options");
-    // 相机配置
+    // Camera configuration
     d(this, "camera");
-    // 矩阵缓存（复用缓冲区，避免每帧分配）
+    // Matrix cache (reuse buffers to avoid per-frame allocation)
     d(this, "viewMatrix", new Float32Array(16));
     d(this, "projectionMatrix", new Float32Array(16));
     // 当前数据（GPU 格式：[pos3, color4, cov6] x N）
@@ -5233,7 +5233,7 @@ class Mi {
     };
   }
   /**
-   * 初始化渲染系统
+   * Initialize render system
    */
   async initialize() {
     const { preferBackend: e, backgroundColor: t = [0, 0, 0, 0] } = this.options;
@@ -5247,10 +5247,10 @@ class Mi {
     this.renderer = new Pi(this.canvas, t), await this.renderer.initialize(), this.backend = "webgl", h.log("✅ Using WebGL renderer"), this.updateCameraAspect();
   }
   /**
-   * 加载已打包的 Splat 数据（零拷贝，GPU 格式）
-   * 直接接收 WASM 的 packed 数据
+   * Load packed Splat data (zero-copy, GPU format)
+   * Directly receives WASM packed data
    *
-   * @param packedData Float32Array [pos3, color4, cov6] x N 个点
+   * @param packedData Float32Array [pos3, color4, cov6] x N points
    */
   loadSplatsFromPackedData(e) {
     if (!this.renderer)
@@ -5283,13 +5283,13 @@ class Mi {
     ), this.renderTime = performance.now() - e;
   }
   /**
-   * 更新相机参数
+   * Update camera parameters
    */
   updateCamera(e) {
     Object.assign(this.camera, e), this.updateCameraAspect();
   }
   /**
-   * 处理窗口大小变化
+   * Handle window resize
    */
   handleResize() {
     this.updateCameraAspect();
@@ -5301,15 +5301,15 @@ class Mi {
     return this.backend;
   }
   /**
-   * 清理资源
+   * Dispose resources
    */
   dispose() {
     var e;
     (e = this.renderer) == null || e.dispose(), this.renderer = null, this.originalPackedData = null;
   }
-  // ========== 私有方法 ==========
+  // ========== Private Methods ==========
   /**
-   * 检查 WebGPU 支持
+   * Check WebGPU support
    */
   async checkWebGPUSupport() {
     if (!navigator.gpu)
@@ -5321,13 +5321,13 @@ class Mi {
     }
   }
   /**
-   * 更新相机长宽比
+   * Update camera aspect ratio
    */
   updateCameraAspect() {
     this.camera.aspect = this.canvas.width / this.canvas.height;
   }
   /**
-   * 更新相机矩阵
+   * Update camera matrices
    */
   updateCameraMatrices() {
     const { position: e, target: t, up: n } = this.camera;
@@ -5339,7 +5339,7 @@ class Mi {
     ), this.updateViewMatrix(e, t, n);
   }
   /**
-   * 获取相机前向向量
+   * Get camera forward vector
    */
   getCameraForward() {
     const e = [
@@ -5352,16 +5352,16 @@ class Mi {
     return t > 0 && (e[0] /= t, e[1] /= t, e[2] /= t), e;
   }
   /**
-   * 更新透视投影矩阵（复用缓冲区）
+   * Update perspective projection matrix (reuse buffer)
    */
   updatePerspectiveMatrix(e, t, n, i) {
     const a = e * Math.PI / 180, o = 1 / Math.tan(a / 2), s = i / (n - i), l = this.projectionMatrix;
     l[0] = o / t, l[1] = 0, l[2] = 0, l[3] = 0, l[4] = 0, l[5] = o, l[6] = 0, l[7] = 0, l[8] = 0, l[9] = 0, l[10] = s, l[11] = -1, l[12] = 0, l[13] = 0, l[14] = s * n, l[15] = 0;
   }
   /**
-   * 更新视图矩阵（直接更新预分配的缓冲区，避免每帧分配）
-   * 等价于：inverse(translation) * inverse(rotation) = T^(-1) * R^(-1)
-   * 其中 T 是平移矩阵，R 是旋转矩阵
+   * Update view matrix (directly update pre-allocated buffer to avoid per-frame allocation)
+   * Equivalent to: inverse(translation) * inverse(rotation) = T^(-1) * R^(-1)
+   * Where T is translation matrix, R is rotation matrix
    */
   updateViewMatrix(e, t, n) {
     const i = [
@@ -5966,6 +5966,7 @@ class Oi {
   /**
    * 获取渲染性能统计
    * @returns 渲染性能统计数据，如果渲染系统未初始化则返回 null
+   * @internal Not part of public API yet
    */
   getPerformanceStats() {
     return !this.renderSystem || !this.isInitialized ? null : {
@@ -5996,4 +5997,4 @@ export {
   Di as k,
   h as l
 };
-//# sourceMappingURL=index-bQnEVIkT.js.map
+//# sourceMappingURL=index-CDG7huUa.js.map