@spatialwalk/avatarkit 1.0.0-beta.22 → 1.0.0-beta.23

package/CHANGELOG.md

@@ -5,6 +5,11 @@ 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.23] - 2025-01-26
+
+### 🔧 API Changes
+- **Breaking Change** - `playback()` method is no longer supported and has been removed from public API
+
 ## [1.0.0-beta.22] - 2025-01-26
 
 ### 🔧 API Changes

package/README.md

@@ -28,7 +28,8 @@ import {
   AvatarManager, 
   AvatarView,
   Configuration,
-  Environment 
+  Environment,
+  DrivingServiceMode
 } from '@spatialwalk/avatarkit'
 
 // 1. Initialize SDK
@@ -61,12 +62,9 @@ const avatarView = new AvatarView(avatar, container)
 // 4. Start real-time communication (SDK mode only)
 await avatarView.avatarController.start()
 
-// 5. Send audio data (SDK mode)
-// ⚠️ Important: Audio must be 16kHz mono PCM16 format
-// If audio is Uint8Array, you can use slice().buffer to convert to ArrayBuffer
-const audioUint8 = new Uint8Array(1024) // Example: 16kHz PCM16 audio data (512 samples = 1024 bytes)
-const audioData = audioUint8.slice().buffer // Simplified conversion, works for ArrayBuffer and SharedArrayBuffer
-avatarView.avatarController.send(audioData, false) // Send audio data, will automatically start playing after accumulating enough data
+// 5. Send audio data (SDK mode, must be 16kHz mono PCM16 format)
+const audioData = new ArrayBuffer(1024) // Example: 16kHz PCM16 audio data
+avatarView.avatarController.send(audioData, false) // Send audio data
 avatarView.avatarController.send(audioData, true) // end=true marks the end of current conversation round
 ```
 
@@ -81,22 +79,9 @@ const container = document.getElementById('avatar-container')
 const avatarView = new AvatarView(avatar, container)
 
 // 4. Host Mode Workflow:
-// ⚠️ IMPORTANT: In Host mode, you MUST send audio data FIRST to get a conversationId,
-//    then use that conversationId to send animation data.
-//    Animation data with mismatched conversationId will be discarded.
-
-// Option A: Playback existing audio and animation data (replay mode)
-const initialAudioChunks = [{ data: audioData1, isLast: false }, { data: audioData2, isLast: false }]
-const initialKeyframes = animationData1 // Animation keyframes from your service
-// Step 1: Send audio first to get conversationId
-const conversationId = await avatarView.avatarController.playback(initialAudioChunks, initialKeyframes)
-
-// Option B: Stream new audio and animation data (start a new session directly)
-// Step 1: Send audio data first to get conversationId (automatically generates conversationId if starting new session)
-const currentConversationId = avatarView.avatarController.yieldAudioData(audioData3, false)
-// Step 2: Use the conversationId to send animation data (mismatched conversationId will be discarded)
-avatarView.avatarController.yieldFramesData(animationData2, currentConversationId || conversationId)
-// Note: To start playback, you need to call playback() with the accumulated data, or ensure enough audio data is sent
+// Send audio data first to get conversationId, then use it to send animation data
+const conversationId = avatarView.avatarController.yieldAudioData(audioData, false)
+avatarView.avatarController.yieldFramesData(animationData, conversationId)
 ```
 
 ### Complete Examples
@@ -184,15 +169,9 @@ RenderSystem → WebGPU/WebGL → Canvas rendering
 ```
 External data source (audio + animation)
     ↓
-Step 1: Send audio data FIRST to get conversationId
-    ↓
-AvatarController.playback(initialAudio, initialKeyframes) // Returns conversationId
-    OR
 AvatarController.yieldAudioData(audioChunk) // Returns conversationId
     ↓
-Step 2: Use conversationId to send animation data
-    ↓
-AvatarController.yieldFramesData(keyframes, conversationId) // Requires conversationId
+AvatarController.yieldFramesData(keyframes, conversationId)
     ↓
 AvatarController → AnimationPlayer (synchronized playback)
     ↓
@@ -203,10 +182,6 @@ AvatarController (playback loop) → AvatarView.renderRealtimeFrame()
 RenderSystem → WebGPU/WebGL → Canvas rendering
 ```
 
-**Note:** 
-- In SDK mode, users provide audio data, SDK handles network communication and animation data reception
-- In Host mode, users provide both audio and animation data, SDK handles synchronized playback only
-
 ### Audio Format Requirements
 
 **⚠️ Important:** The SDK requires audio data to be in **16kHz mono PCM16** format:
@@ -286,14 +261,25 @@ manager.clearCache()
 
 3D rendering view (rendering layer), responsible for 3D rendering only. Internally automatically creates and manages `AvatarController`.
 
-**Playback Mode Configuration:**
+```typescript
+constructor(avatar: Avatar, container: HTMLElement)
+```
+
+**Parameters:**
+- `avatar`: Avatar 实例
+- `container`: Canvas 容器元素（必选）
+  - Canvas 自动使用容器的完整尺寸（宽度和高度）
+  - Canvas 宽高比适应容器尺寸 - 设置容器尺寸以控制宽高比
+  - Canvas 会自动添加到容器中
+  - SDK automatically handles resize events via ResizeObserver
+
+**Playback Mode:**
+- The playback mode is determined by `drivingServiceMode` in `AvatarKit.initialize()` configuration
 - The playback mode is fixed when creating `AvatarView` and persists throughout its lifecycle
 - Cannot be changed after creation
 
 ```typescript
-
 // Create view (Canvas is automatically added to container)
-// Create view (playback mode is determined by drivingServiceMode in AvatarKit configuration)
 const container = document.getElementById('avatar-container')
 const avatarView = new AvatarView(avatar, container)
 
@@ -319,7 +305,7 @@ const newAvatar = await avatarManager.load('new-character-id')
 currentAvatarView = new AvatarView(newAvatar, container)
 
 // SDK mode: start connection (will throw error if not in SDK mode)
-await currentAvatarView.controller.start()
+  await currentAvatarView.controller.start()
 ```
 
 ### AvatarController
@@ -334,14 +320,9 @@ Audio/animation playback controller (playback layer), manages synchronized playb
 // Start WebSocket service
 await avatarView.avatarController.start()
 
-// Send audio data
+// Send audio data (must be 16kHz mono PCM16 format)
 const conversationId = avatarView.avatarController.send(audioData: ArrayBuffer, end: boolean)
-// Returns: conversationId - Conversation ID for this conversation session (used to distinguish each conversation round)
-// audioData: Audio data (ArrayBuffer format, must be 16kHz mono PCM16)
-//   - Sample rate: 16kHz (16000 Hz) - backend requirement
-//   - Format: PCM16 (16-bit signed integer, little-endian)
-//   - Channels: Mono (single channel)
-//   - Example: 1 second = 16000 samples × 2 bytes = 32000 bytes
+// Returns: conversationId - Conversation ID for this conversation session
 // end: false (default) - Continue sending audio data for current conversation
 // end: true - Mark the end of current conversation round. After end=true, sending new audio data will interrupt any ongoing playback from the previous conversation round
 
@@ -352,25 +333,17 @@ avatarView.avatarController.close()
 #### Host Mode Methods
 
 ```typescript
-// Playback existing audio and animation data (starts a new conversation)
-const conversationId = await avatarView.avatarController.playback(
-  initialAudioChunks?: Array<{ data: Uint8Array, isLast: boolean }>,  // Existing audio chunks (16kHz mono PCM16)
-  initialKeyframes?: any[]  // Existing animation keyframes (obtained from your service)
-)
-// Returns: conversationId - New conversation ID for this conversation session
-
-// Stream audio chunks (can be called directly to start a new session, or after playback() to add more data)
+// Stream audio chunks (must be 16kHz mono PCM16 format)
 const conversationId = avatarView.avatarController.yieldAudioData(
   data: Uint8Array,               // Audio chunk data
   isLast: boolean = false         // Whether this is the last chunk
 )
 // Returns: conversationId - Conversation ID for this audio session
-// Note: If no conversationId exists, a new one will be automatically generated
 
 // Stream animation keyframes (requires conversationId from audio data)
 avatarView.avatarController.yieldFramesData(
   keyframes: any[],                // Animation keyframes (obtained from your service)
-  conversationId: string                    // Conversation ID (required). Use getCurrentConversationId() or yieldAudioData() to get conversationId.
+  conversationId: string          // Conversation ID (required)
 )
 ```
 
@@ -378,36 +351,14 @@ avatarView.avatarController.yieldFramesData(
 
 **SDK Mode:**
 - `send()` returns a conversationId to distinguish each conversation round
-- `end=true` marks the end of a conversation round. After `end=true`, sending new audio data will interrupt any ongoing playback from the previous conversation round
+- `end=true` marks the end of a conversation round
 
 **Host Mode:**
-For each conversation session, you **must**:
-1. **First send audio data** to get a conversationId (used to distinguish each conversation round):
-   - `playback()` returns a conversationId when playback existing audio and animation data (replay mode)
-   - `yieldAudioData()` returns a conversationId for streaming new audio data
-2. **Then use that conversationId** to send animation data:
+- `yieldAudioData()` returns a conversationId (automatically generates if starting new session)
    - `yieldFramesData()` requires a valid conversationId parameter
    - Animation data with mismatched conversationId will be **discarded**
    - Use `getCurrentConversationId()` to retrieve the current active conversationId
 
-**Example Flow (Host Mode):**
-```typescript
-// Option A: Playback existing complete data (replay mode)
-const conversationId = await avatarView.avatarController.playback(initialAudioChunks, initialKeyframes)
-
-// Option B: Start streaming new data directly
-// Step 1: Send audio data first to get conversationId (automatically generates if starting new session)
-const conversationId = avatarView.avatarController.yieldAudioData(audioChunk, false)
-// Step 2: Use the conversationId to send animation data
-avatarView.avatarController.yieldFramesData(keyframes, conversationId)
-// Note: To start playback with Option B, call playback() with accumulated data or ensure enough audio is sent
-```
-
-**Why conversationId is required:**
-- Ensures audio and animation data belong to the same conversation session
-- Prevents data from different sessions from being mixed
-- Automatically discards mismatched animation data for data integrity
-
 #### Common Methods (Both Modes)
 
 ```typescript
@@ -439,11 +390,9 @@ avatarView.avatarController.onError = (error: Error) => {}
 
 **Important Notes:**
 - `start()` and `close()` are only available in SDK mode
-- `playback()`, `yieldAudioData()`, and `yieldFramesData()` are only available in Host mode
+- `yieldAudioData()` and `yieldFramesData()` are only available in Host mode
 - `pause()`, `resume()`, `interrupt()`, `clear()`, `getCurrentConversationId()`, `setVolume()`, and `getVolume()` are available in both modes
 - The playback mode is determined when creating `AvatarView` and cannot be changed
-- **Conversation ID**: In Host mode, always send audio data first to obtain a conversationId, then use that conversationId when sending animation data. Animation data with mismatched conversationId will be discarded. Use `getCurrentConversationId()` to retrieve the current active conversationId.
-- **Volume Control**: Use `setVolume(volume)` to control audio playback volume (0.0 to 1.0). This only affects the avatar's audio player, not system volume. Volume changes take effect immediately, including for currently playing audio.
 
 ## 🔧 Configuration
 
@@ -471,29 +420,6 @@ enum Environment {
 }
 ```
 
-### AvatarView Constructor
-
-```typescript
-constructor(avatar: Avatar, container: HTMLElement)
-```
-
-**Parameters:**
-- `avatar`: Avatar 实例
-- `container`: Canvas 容器元素（必选）
-  - Canvas 自动使用容器的完整尺寸（宽度和高度）
-  - Canvas 宽高比适应容器尺寸 - 设置容器尺寸以控制宽高比
-  - Canvas 会自动添加到容器中
-
-**Note:** 播放模式由 `AvatarKit.initialize()` 配置中的 `drivingServiceMode` 决定，而不是在构造函数参数中
-  - SDK automatically handles resize events via ResizeObserver
-
-```typescript
-enum DrivingServiceMode {
-  sdk = 'sdk',   // SDK mode: SDK handles WebSocket communication
-  host = 'host'  // Host mode: Host provides data, SDK handles playback
-}
-```
-
 ### CameraConfig
 
 ```typescript
@@ -604,13 +530,8 @@ const container = document.getElementById('avatar-container')
 const avatarView = new AvatarView(avatar, container)
 
 // Use
-const initialAudioChunks = [{ data: audioData1, isLast: false }]
-// Step 1: Send audio first to get conversationId
-const conversationId = await avatarView.avatarController.playback(initialAudioChunks, initialKeyframes)
-// Step 2: Stream additional audio (returns conversationId)
-const currentConversationId = avatarView.avatarController.yieldAudioData(audioChunk, false)
-// Step 3: Use conversationId to send animation data (mismatched conversationId will be discarded)
-avatarView.avatarController.yieldFramesData(keyframes, currentConversationId || conversationId)
+const conversationId = avatarView.avatarController.yieldAudioData(audioChunk, false)
+avatarView.avatarController.yieldFramesData(keyframes, conversationId)
 
 // Cleanup
 avatarView.avatarController.clear() // Clear all data and resources
@@ -629,67 +550,6 @@ avatarView.dispose() // Automatically cleans up all resources
 - Supports dynamic loading/unloading of character and animation resources
 - Provides memory usage monitoring interface
 
-### Audio Data Sending
-
-#### SDK Mode
-
-The `send()` method receives audio data in `ArrayBuffer` format:
-
-**Audio Format Requirements:**
-- **Sample Rate**: 16kHz (16000 Hz) - **Backend requirement, must be exactly 16kHz**
-- **Format**: PCM16 (16-bit signed integer, little-endian)
-- **Channels**: Mono (single channel)
-- **Data Size**: Each sample is 2 bytes, so 1 second of audio = 16000 samples × 2 bytes = 32000 bytes
-
-**Usage:**
-- `audioData`: Audio data (ArrayBuffer format, must be 16kHz mono PCM16)
-- `end=false` (default) - Continue sending audio data for current conversation
-- `end=true` - Mark the end of current conversation round. After `end=true`, sending new audio data will interrupt any ongoing playback from the previous conversation round
-- **Important**: No need to wait for `end=true` to start playing, it will automatically start playing after accumulating enough audio data
-
-#### Host Mode
-
-The `playback()` method is used to playback existing audio and animation data (replay mode), generating a new conversationId and interrupting any existing conversation. 
-
-**Two ways to start a session in Host mode:**
-1. **Use `playback()`** - For replaying existing complete audio and animation data
-2. **Use `yieldAudioData()` directly** - For streaming new audio data (automatically generates conversationId if needed)
-
-Then use `yieldAudioData()` to stream additional audio:
-
-**Audio Format Requirements:**
-- Same as SDK mode: 16kHz mono PCM16 format
-- Audio data should be provided as `Uint8Array` in chunks with `isLast` flag
-
-**Usage:**
-```typescript
-// Playback existing audio and animation data (starts a new conversation)
-// Note: Audio and animation data should be obtained from your backend service
-const initialAudioChunks = [
-  { data: audioData1, isLast: false },
-  { data: audioData2, isLast: false }
-]
-const conversationId = await avatarController.playback(initialAudioChunks, initialKeyframes)
-// Returns: conversationId - New conversation ID for this conversation session
-
-// Stream additional audio chunks
-const conversationId = avatarController.yieldAudioData(audioChunk, isLast)
-// Returns: conversationId - Conversation ID for this audio session
-```
-
-**⚠️ Conversation ID Workflow:**
-1. **Start a session** → Choose one of two ways:
-   - **Option A**: Use `playback(initialAudioChunks, initialKeyframes)` to replay existing complete data
-   - **Option B**: Use `yieldAudioData(audioChunk)` directly to start streaming (automatically generates conversationId)
-2. **Get conversationId** → Both methods return a conversationId
-3. **Send animation with conversationId** → Use the conversationId from step 1 in `yieldFramesData()`
-4. **Data matching** → Only animation data with matching conversationId will be accepted
-
-**Resampling (Both Modes):**
-- If your audio source is at a different sample rate (e.g., 24kHz, 48kHz), you **must** resample it to 16kHz before sending
-- For high-quality resampling, use Web Audio API's `OfflineAudioContext` with anti-aliasing filtering
-- See example projects (`vanilla`, `react`, `vue`) for complete resampling implementation
-
 ## 🌐 Browser Compatibility
 
 - **Chrome/Edge** 90+ (WebGPU recommended)

package/dist/{StreamingAudioPlayer-DjPD7f6u.js → StreamingAudioPlayer-PkzxBP93.js}

@@ -1,7 +1,7 @@
 var C = Object.defineProperty;
 var g = (h, t, e) => t in h ? C(h, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : h[t] = e;
 var s = (h, t, e) => g(h, typeof t != "symbol" ? t + "" : t, e);
-import { A as m, e as f, a as c, l as n } from "./index-BB9yoGY2.js";
+import { A as m, e as f, a as c, l as n } from "./index-DYf1u8L7.js";
 class y {
   constructor(t) {
     // AudioContext is managed internally
@@ -350,4 +350,4 @@ class y {
 export {
   y as StreamingAudioPlayer
 };
-//# sourceMappingURL=StreamingAudioPlayer-DjPD7f6u.js.map
+//# sourceMappingURL=StreamingAudioPlayer-PkzxBP93.js.map

package/dist/{StreamingAudioPlayer-DjPD7f6u.js.map → StreamingAudioPlayer-PkzxBP93.js.map}

@@ -1 +1 @@
-{"version":3,"file":"StreamingAudioPlayer-DjPD7f6u.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 pausedAudioContextTime = 0 // audioContext.currentTime when paused (for resume calculation)\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 = new Set<AudioBufferSourceNode>()\n\n  // Volume control\n  private gainNode: GainNode | null = null\n  private volume: number = 1.0 // Default volume 1.0 (0.0 - 1.0)\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      // Create GainNode for volume control\n      this.gainNode = this.audioContext.createGain()\n      this.gainNode.gain.value = this.volume\n      this.gainNode.connect(this.audioContext.destination)\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 and not paused\n    else if (this.isPlaying && !this.isPaused) {\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    this.pausedAudioContextTime = 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.size,\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 || this.isPaused) {\n      this.log('[StreamingAudioPlayer] Cannot schedule chunk: Not playing or paused')\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      // Connect through gainNode for volume control\n      source.connect(this.gainNode!)\n\n      // Schedule playback\n      source.start(this.scheduledTime)\n\n      // Track active source for hard-cancel\n      this.activeSources.add(source)\n      source.onended = () => {\n        // Remove from active list when it ends\n        this.activeSources.delete(source)\n\n        // Check if this was the last chunk and all sources have ended\n        if (isLast && this.activeSources.size === 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.size,\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 || !this.audioContext) {\n      return\n    }\n\n    // 1. 记录逻辑时间（用于 getCurrentTime 返回固定值）\n    this.pausedAt = this.getCurrentTime()\n\n    // 2. 记录 AudioContext 时间戳（关键！用于恢复计算）\n    this.pausedAudioContextTime = this.audioContext.currentTime\n\n    // 3. 设置暂停标志\n    this.isPaused = true\n\n    // 4. 挂起 AudioContext 以暂停所有活动的音频源\n    if (this.audioContext.state === 'running') {\n      this.audioContext.suspend().catch((err) => {\n        logger.errorWithError('Failed to suspend AudioContext:', err)\n        // 如果挂起失败，恢复状态\n        this.isPaused = false\n      })\n    }\n\n    this.log('Playback paused', {\n      pausedAt: this.pausedAt,\n      pausedAudioContextTime: this.pausedAudioContextTime,\n      audioContextState: this.audioContext.state,\n    })\n  }\n\n  /**\n   * Resume playback\n   */\n  async resume(): Promise<void> {\n    if (!this.isPaused || !this.audioContext || !this.isPlaying) {\n      return\n    }\n\n    // 1. 首先恢复 AudioContext（使 currentTime 继续）\n    if (this.audioContext.state === 'suspended') {\n      try {\n        await this.audioContext.resume()\n      }\n      catch (err) {\n        logger.errorWithError('Failed to resume AudioContext:', err)\n        throw err\n      }\n    }\n\n    // 2. 调整 sessionStartTime，使 getCurrentTime() 从 pausedAt 继续\n    // 数学推导：\n    // 恢复后，我们希望：getCurrentTime() = pausedAt + (currentAudioTime - pausedAudioContextTime)\n    // 当前公式：getCurrentTime() = currentAudioTime - sessionStartTime - pausedTimeOffset\n    //\n    // 令两者相等：\n    // pausedAt + (currentAudioTime - pausedAudioContextTime) = currentAudioTime - sessionStartTime - pausedTimeOffset\n    // => sessionStartTime = pausedAudioContextTime - pausedAt - pausedTimeOffset\n    const currentAudioTime = this.audioContext.currentTime\n    this.sessionStartTime = this.pausedAudioContextTime - this.pausedAt - this.pausedTimeOffset\n\n    // 3. 清除暂停标志\n    this.isPaused = false\n\n    // 4. 继续调度未调度的音频块（如果在暂停期间有新数据到达）\n    if (this.scheduledChunks < this.audioChunks.length) {\n      this.scheduleAllChunks()\n    }\n\n    this.log('Playback resumed', {\n      pausedAt: this.pausedAt,\n      pausedAudioContextTime: this.pausedAudioContextTime,\n      currentAudioContextTime: currentAudioTime,\n      adjustedSessionStartTime: this.sessionStartTime,\n      audioContextState: this.audioContext.state,\n    })\n  }\n\n  /**\n   * Stop playback\n   */\n  stop(): void {\n    if (!this.audioContext) {\n      return\n    }\n\n    // 如果暂停，先恢复 AudioContext（以便正确停止源）\n    if (this.isPaused && this.audioContext.state === 'suspended') {\n      this.audioContext.resume().catch(() => {\n        // 忽略恢复错误，因为我们要停止播放\n      })\n      this.isPaused = false\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.clear()\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      this.gainNode = 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.pausedAudioContextTime = 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   * 设置音量 (0.0 - 1.0)\n   * 注意：这仅控制数字人音频播放器的音量，不影响系统音量\n   * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）\n   */\n  setVolume(volume: number): void {\n    if (volume < 0 || volume > 1) {\n      logger.warn(`[StreamingAudioPlayer] Volume out of range: ${volume}, clamping to [0, 1]`)\n      volume = Math.max(0, Math.min(1, volume))\n    }\n\n    this.volume = volume\n    if (this.gainNode) {\n      this.gainNode.gain.value = volume\n    }\n  }\n\n  /**\n   * 获取当前音量\n   * @returns 当前音量值 (0.0 - 1.0)\n   */\n  getVolume(): number {\n    return this.volume\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","err","numSamples","channel","alignedData","int16Array","channelData","i","sampleIndex","elapsed","currentAudioTime","enabled","_a","callback","totalSamples","total","played","volume","data"],"mappings":"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"}
+{"version":3,"file":"StreamingAudioPlayer-PkzxBP93.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 pausedAudioContextTime = 0 // audioContext.currentTime when paused (for resume calculation)\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 = new Set<AudioBufferSourceNode>()\n\n  // Volume control\n  private gainNode: GainNode | null = null\n  private volume: number = 1.0 // Default volume 1.0 (0.0 - 1.0)\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      // Create GainNode for volume control\n      this.gainNode = this.audioContext.createGain()\n      this.gainNode.gain.value = this.volume\n      this.gainNode.connect(this.audioContext.destination)\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 and not paused\n    else if (this.isPlaying && !this.isPaused) {\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    this.pausedAudioContextTime = 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.size,\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 || this.isPaused) {\n      this.log('[StreamingAudioPlayer] Cannot schedule chunk: Not playing or paused')\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      // Connect through gainNode for volume control\n      source.connect(this.gainNode!)\n\n      // Schedule playback\n      source.start(this.scheduledTime)\n\n      // Track active source for hard-cancel\n      this.activeSources.add(source)\n      source.onended = () => {\n        // Remove from active list when it ends\n        this.activeSources.delete(source)\n\n        // Check if this was the last chunk and all sources have ended\n        if (isLast && this.activeSources.size === 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.size,\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 || !this.audioContext) {\n      return\n    }\n\n    // 1. 记录逻辑时间（用于 getCurrentTime 返回固定值）\n    this.pausedAt = this.getCurrentTime()\n\n    // 2. 记录 AudioContext 时间戳（关键！用于恢复计算）\n    this.pausedAudioContextTime = this.audioContext.currentTime\n\n    // 3. 设置暂停标志\n    this.isPaused = true\n\n    // 4. 挂起 AudioContext 以暂停所有活动的音频源\n    if (this.audioContext.state === 'running') {\n      this.audioContext.suspend().catch((err) => {\n        logger.errorWithError('Failed to suspend AudioContext:', err)\n        // 如果挂起失败，恢复状态\n        this.isPaused = false\n      })\n    }\n\n    this.log('Playback paused', {\n      pausedAt: this.pausedAt,\n      pausedAudioContextTime: this.pausedAudioContextTime,\n      audioContextState: this.audioContext.state,\n    })\n  }\n\n  /**\n   * Resume playback\n   */\n  async resume(): Promise<void> {\n    if (!this.isPaused || !this.audioContext || !this.isPlaying) {\n      return\n    }\n\n    // 1. 首先恢复 AudioContext（使 currentTime 继续）\n    if (this.audioContext.state === 'suspended') {\n      try {\n        await this.audioContext.resume()\n      }\n      catch (err) {\n        logger.errorWithError('Failed to resume AudioContext:', err)\n        throw err\n      }\n    }\n\n    // 2. 调整 sessionStartTime，使 getCurrentTime() 从 pausedAt 继续\n    // 数学推导：\n    // 恢复后，我们希望：getCurrentTime() = pausedAt + (currentAudioTime - pausedAudioContextTime)\n    // 当前公式：getCurrentTime() = currentAudioTime - sessionStartTime - pausedTimeOffset\n    //\n    // 令两者相等：\n    // pausedAt + (currentAudioTime - pausedAudioContextTime) = currentAudioTime - sessionStartTime - pausedTimeOffset\n    // => sessionStartTime = pausedAudioContextTime - pausedAt - pausedTimeOffset\n    const currentAudioTime = this.audioContext.currentTime\n    this.sessionStartTime = this.pausedAudioContextTime - this.pausedAt - this.pausedTimeOffset\n\n    // 3. 清除暂停标志\n    this.isPaused = false\n\n    // 4. 继续调度未调度的音频块（如果在暂停期间有新数据到达）\n    if (this.scheduledChunks < this.audioChunks.length) {\n      this.scheduleAllChunks()\n    }\n\n    this.log('Playback resumed', {\n      pausedAt: this.pausedAt,\n      pausedAudioContextTime: this.pausedAudioContextTime,\n      currentAudioContextTime: currentAudioTime,\n      adjustedSessionStartTime: this.sessionStartTime,\n      audioContextState: this.audioContext.state,\n    })\n  }\n\n  /**\n   * Stop playback\n   */\n  stop(): void {\n    if (!this.audioContext) {\n      return\n    }\n\n    // 如果暂停，先恢复 AudioContext（以便正确停止源）\n    if (this.isPaused && this.audioContext.state === 'suspended') {\n      this.audioContext.resume().catch(() => {\n        // 忽略恢复错误，因为我们要停止播放\n      })\n      this.isPaused = false\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.clear()\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      this.gainNode = 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.pausedAudioContextTime = 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   * 设置音量 (0.0 - 1.0)\n   * 注意：这仅控制数字人音频播放器的音量，不影响系统音量\n   * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）\n   */\n  setVolume(volume: number): void {\n    if (volume < 0 || volume > 1) {\n      logger.warn(`[StreamingAudioPlayer] Volume out of range: ${volume}, clamping to [0, 1]`)\n      volume = Math.max(0, Math.min(1, volume))\n    }\n\n    this.volume = volume\n    if (this.gainNode) {\n      this.gainNode.gain.value = volume\n    }\n  }\n\n  /**\n   * 获取当前音量\n   * @returns 当前音量值 (0.0 - 1.0)\n   */\n  getVolume(): number {\n    return this.volume\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","err","numSamples","channel","alignedData","int16Array","channelData","i","sampleIndex","elapsed","currentAudioTime","enabled","_a","callback","totalSamples","total","played","volume","data"],"mappings":"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"}

package/dist/core/AvatarController.d.ts

@@ -53,17 +53,6 @@ export declare class AvatarController {
      * Close service (SDK mode only)
      */
     close(): void;
-    /**
-     * Playback existing audio and animation data (host mode)
-     * Starts a new conversation by generating a new conversation ID and interrupting any existing conversation
-     * @param initialAudioChunks - Existing audio chunks to playback
-     * @param initialKeyframes - Existing animation keyframes to playback
-     * @returns conversationId - New conversation ID for this conversation session
-     */
-    playback(initialAudioChunks?: Array<{
-        data: Uint8Array;
-        isLast: boolean;
-    }>, initialKeyframes?: Flame[]): Promise<string>;
     /**
      * Send audio data (host mode)
      * Stream additional audio data after playback()

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

@@ -1 +1 @@
-{"version":3,"file":"AvatarController.d.ts","sourceRoot":"","sources":["../../core/AvatarController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AvatarController.d.ts","sourceRoot":"","sources":["../../core/AvatarController.ts"],"names":[],"mappings":"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"}

package/dist/{index-BB9yoGY2.js → index-DYf1u8L7.js}

@@ -2061,7 +2061,7 @@ class y {
     h[i](`[Telemetry] ${e}`, a);
   }
 }
-u(y, "_isInitialized", !1), u(y, "_appId", null), u(y, "_configuration", null), u(y, "_sessionToken", null), u(y, "_userId", null), u(y, "_version", "1.0.0-beta.22"), u(y, "_avatarCore", null), u(y, "_dynamicSdkConfig", null), u(y, "_logLevels", {
+u(y, "_isInitialized", !1), u(y, "_appId", null), u(y, "_configuration", null), u(y, "_sessionToken", null), u(y, "_userId", null), u(y, "_version", "1.0.0-beta.23"), u(y, "_avatarCore", null), u(y, "_dynamicSdkConfig", null), u(y, "_logLevels", {
   debug: "log",
   info: "log",
   warning: "warn",
@@ -2130,7 +2130,7 @@ const Ae = class Ae {
   async createAndInitializeStreamingPlayer() {
     if (this.streamingPlayer)
       return;
-    const { StreamingAudioPlayer: e } = await import("./StreamingAudioPlayer-DjPD7f6u.js");
+    const { StreamingAudioPlayer: e } = await import("./StreamingAudioPlayer-PkzxBP93.js");
     this.streamingPlayer = new e({
       sampleRate: k.audio.sampleRate,
       channelCount: 1,
@@ -3888,6 +3888,7 @@ class Ca {
    * @param initialAudioChunks - Existing audio chunks to playback
    * @param initialKeyframes - Existing animation keyframes to playback
    * @returns conversationId - New conversation ID for this conversation session
+   * @internal
    */
   async playback(e, t) {
     if ((this.isPlaying || this.currentConversationId) && this.interrupt(), this.currentConversationId = this.generateAndLogNewConversationId(), this.reqEnd = !1, this.clearPlaybackData(), this.animationPlayer || (this.animationPlayer = new oe()), this.animationPlayer.isStreamingReady() || await this.animationPlayer.createAndInitializeStreamingPlayer(), e && e.length > 0 && this.pendingAudioChunks.push(...e), t && t.length > 0 ? (this.currentKeyframes = t, this.emit("keyframesUpdate", this.currentKeyframes)) : (h.warn("[AvatarController] Empty animation data in playback - enabling audio-only mode"), y.logEvent("character_manager", "info", {
@@ -6479,4 +6480,4 @@ export {
   Na as i,
   h as l
 };
-//# sourceMappingURL=index-BB9yoGY2.js.map
+//# sourceMappingURL=index-DYf1u8L7.js.map