@spatialwalk/avatarkit 1.0.0-beta.16 → 1.0.0-beta.17

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.17] - 2025-01-24
+
+### ✨ New Features
+- **Audio-Only Fallback Mechanism** - SDK now includes automatic fallback to audio-only playback when animation data is unavailable
+  - Network mode: Automatically enters audio-only mode when server returns an error
+  - Host mode: Automatically enters audio-only mode when empty animation data is provided
+  - Once in audio-only mode, subsequent animation data for that session is ignored
+  - Fallback mode is interruptible, just like normal playback mode
+
+### 🔧 API Changes
+- **Playback Mode Configuration** - Moved playback mode configuration from `AvatarView` constructor to `AvatarKit.initialize()`
+  - Playback mode is now determined by `drivingServiceMode` in `AvatarKit.initialize()` configuration
+  - `AvatarView` constructor now only requires `avatar` and `container` parameters
+  - Removed `AvatarViewOptions` interface
+  - `container` parameter is now required (no longer optional)
+
+### 🔧 Improvements
+- Extended transition animation duration from 200ms to 400ms for smoother end-of-playback transitions
+
+### 📚 Documentation
+- Updated README.md to use "SDK mode" and "Host mode" terminology instead of "Network mode" and "External data mode"
+- Added fallback mechanism documentation
+- Updated API reference to reflect new constructor signature
+
 ## [1.0.0-beta.16] - 2025-11-21
 
 ### ✨ New Features
@@ -174,7 +198,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **External Data Mode**:
   - External components fully control audio and animation data acquisition
   - SDK only responsible for synchronized playback of externally provided data
-  - Use `controller.play()`, `controller.sendAudioChunk()` and `controller.sendKeyframes()` methods
+  - Use `controller.playback()`, `controller.yieldAudioData()` and `controller.yieldFramesData()` methods
 
 ### ✨ New Features
 

package/README.md

@@ -32,8 +32,13 @@ import {
 } from '@spatialwalk/avatarkit'
 
 // 1. Initialize SDK
+import { DrivingServiceMode } from '@spatialwalk/avatarkit'
+
 const configuration: Configuration = {
   environment: Environment.test,
+  drivingServiceMode: DrivingServiceMode.sdk, // Optional, 'sdk' is default
+  // - DrivingServiceMode.sdk: SDK mode (network mode) - SDK handles WebSocket communication
+  // - DrivingServiceMode.host: Host mode (external data mode) - Host app provides audio and animation data
 }
 
 await AvatarKit.initialize('your-app-id', configuration)
@@ -48,12 +53,11 @@ const avatar = await avatarManager.load('character-id', (progress) => {
 })
 
 // 3. Create view (automatically creates Canvas and AvatarController)
-// Network mode (default)
+// The playback mode is determined by drivingServiceMode in AvatarKit configuration
+// - DrivingServiceMode.sdk: SDK mode (network mode) - SDK handles WebSocket communication
+// - DrivingServiceMode.host: Host mode (external data mode) - Host app provides audio and animation data
 const container = document.getElementById('avatar-container')
-const avatarView = new AvatarView(avatar, {
-  container: container,
-  playbackMode: 'network' // Optional, 'network' is default
-})
+const avatarView = new AvatarView(avatar, container)
 
 // 4. Start real-time communication (network mode only)
 await avatarView.avatarController.start()
@@ -76,21 +80,26 @@ import { AvatarPlaybackMode } from '@spatialwalk/avatarkit'
 
 // 3. Create view with external data mode
 const container = document.getElementById('avatar-container')
-const avatarView = new AvatarView(avatar, {
-  container: container,
-  playbackMode: AvatarPlaybackMode.external
-})
+const avatarView = new AvatarView(avatar, container)
+
+// 4. Start playback with initial data (obtained from your service)
+// Note: Audio and animation data should be obtained from your backend service
+const initialAudioChunks = [{ data: audioData1, isLast: false }, { data: audioData2, isLast: false }]
+const initialKeyframes = animationData1 // Animation keyframes from your service
 
 // 4. Start playback with initial data (obtained from your service)
 // Note: Audio and animation data should be obtained from your backend service
 const initialAudioChunks = [{ data: audioData1, isLast: false }, { data: audioData2, isLast: false }]
 const initialKeyframes = animationData1 // Animation keyframes from your service
 
-await avatarView.avatarController.play(initialAudioChunks, initialKeyframes)
+// Step 1: Send audio first to get reqId (required for session management)
+const reqId = await avatarView.avatarController.playback(initialAudioChunks, initialKeyframes)
 
 // 5. Stream additional data as needed
-avatarView.avatarController.sendAudioChunk(audioData3, false)
-avatarView.avatarController.sendKeyframes(animationData2)
+// Important: Always send audio first to get reqId, then use that reqId for animation data
+const currentReqId = avatarView.avatarController.yieldAudioData(audioData3, false)
+// Step 2: Use the reqId to send animation data (mismatched reqId will be discarded)
+avatarView.avatarController.yieldFramesData(animationData2, currentReqId || reqId)
 ```
 
 ### Complete Examples
@@ -122,20 +131,33 @@ The SDK uses a three-layer architecture for clear separation of concerns:
 
 ### Playback Modes
 
-The SDK supports two playback modes, configured when creating `AvatarView`:
+The SDK supports two playback modes, configured in `AvatarKit.initialize()`:
 
-#### 1. Network Mode (Default)
+#### 1. SDK Mode (Default)
+- Configured via `drivingServiceMode: DrivingServiceMode.sdk` in `AvatarKit.initialize()`
 - SDK handles WebSocket communication automatically
 - Send audio data via `AvatarController.send()`
 - SDK receives animation data from backend and synchronizes playback
 - Best for: Real-time audio input scenarios
 
-#### 2. External Data Mode
-- External components manage their own network/data fetching
-- External components provide both audio and animation data
+#### 2. Host Mode
+- Configured via `drivingServiceMode: DrivingServiceMode.host` in `AvatarKit.initialize()`
+- Host application manages its own network/data fetching
+- Host application provides both audio and animation data
 - SDK only handles synchronized playback
 - Best for: Custom data sources, pre-recorded content, or custom network implementations
 
+**Note:** The playback mode is determined by `drivingServiceMode` in `AvatarKit.initialize()` configuration.
+
+### Fallback Mechanism
+
+The SDK includes a fallback mechanism to ensure audio playback continues even when animation data is unavailable:
+
+- **Network Mode**: If the server returns an error or fails to provide animation data, the SDK automatically enters audio-only mode and continues playing audio independently
+- **Host Mode**: If empty animation data is provided (empty array or undefined), the SDK automatically enters audio-only mode
+- Once in audio-only mode, any subsequent animation data for that session will be ignored, and only audio will continue playing
+- The fallback mode is interruptible, just like normal playback mode
+
 ### Data Flow
 
 #### Network Mode Flow
@@ -163,10 +185,10 @@ RenderSystem → WebGPU/WebGL → Canvas rendering
 ```
 External data source (audio + animation)
     ↓
-AvatarController.play(initialAudio, initialKeyframes) // Start playback
+AvatarController.playback(initialAudio, initialKeyframes) // Start playback
     ↓
-AvatarController.sendAudioChunk() // Stream additional audio
-AvatarController.sendKeyframes() // Stream additional animation
+AvatarController.yieldAudioData() // Stream additional audio
+AvatarController.yieldFramesData() // Stream additional animation
     ↓
 AvatarController → AnimationPlayer (synchronized playback)
     ↓
@@ -267,18 +289,9 @@ manager.clearCache()
 import { AvatarPlaybackMode } from '@spatialwalk/avatarkit'
 
 // Create view (Canvas is automatically added to container)
-// Network mode (default)
+// Create view (playback mode is determined by drivingServiceMode in AvatarKit configuration)
 const container = document.getElementById('avatar-container')
-const avatarView = new AvatarView(avatar: Avatar, {
-  container: container,
-  playbackMode: AvatarPlaybackMode.network // Optional, default is 'network'
-})
-
-// External data mode
-const avatarView = new AvatarView(avatar: Avatar, {
-  container: container,
-  playbackMode: AvatarPlaybackMode.external
-})
+const avatarView = new AvatarView(avatar, container)
 
 // Get playback mode
 const mode = avatarView.playbackMode // 'network' | 'external'
@@ -299,10 +312,7 @@ if (currentAvatarView) {
 const newAvatar = await avatarManager.load('new-character-id')
 
 // Create new AvatarView
-currentAvatarView = new AvatarView(newAvatar, {
-  container: container,
-  playbackMode: AvatarPlaybackMode.network
-})
+currentAvatarView = new AvatarView(newAvatar, container)
 
 // Network mode: start connection
 if (currentAvatarView.playbackMode === AvatarPlaybackMode.network) {
@@ -339,24 +349,54 @@ avatarView.avatarController.close()
 #### External Data Mode Methods
 
 ```typescript
-// Start playback with initial audio and animation data
-await avatarView.avatarController.play(
-  initialAudioChunks?: Array<{ data: Uint8Array, isLast: boolean }>,  // Initial audio chunks (16kHz mono PCM16)
-  initialKeyframes?: any[]  // Initial animation keyframes (obtained from your service)
+// Playback existing audio and animation data (starts a new conversation)
+const reqId = 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: reqId - New request ID for this conversation session
 
-// Stream additional audio chunks (after play() is called)
-avatarView.avatarController.sendAudioChunk(
+// Stream additional audio chunks (after playback() is called)
+const reqId = avatarView.avatarController.yieldAudioData(
   data: Uint8Array,               // Audio chunk data
   isLast: boolean = false         // Whether this is the last chunk
 )
+// Returns: reqId - Request ID for this audio session
 
-// Stream additional animation keyframes (after play() is called)
-avatarView.avatarController.sendKeyframes(
-  keyframes: any[]                 // Additional animation keyframes (obtained from your service)
+// Stream additional animation keyframes (after playback() is called)
+avatarView.avatarController.yieldFramesData(
+  keyframes: any[],                // Additional animation keyframes (obtained from your service)
+  reqId: string                    // Request ID (required). Use getCurrentReqId() or yieldAudioData() to get reqId.
 )
 ```
 
+**⚠️ Important: Request ID (reqId) Management**
+
+For each conversation session, you **must**:
+1. **First send audio data** to get a reqId:
+   - `playback()` returns a reqId when starting a new conversation
+   - `yieldAudioData()` returns a reqId for the current audio session
+2. **Then use that reqId** to send animation data:
+   - `yieldFramesData()` requires a valid reqId parameter
+   - Animation data with mismatched reqId will be **discarded**
+   - Use `getCurrentReqId()` to retrieve the current active reqId
+
+**Example Flow:**
+```typescript
+// Step 1: Send audio first to get reqId
+const reqId = await avatarView.avatarController.playback(initialAudioChunks, initialKeyframes)
+// or
+const reqId = avatarView.avatarController.yieldAudioData(audioChunk, false)
+
+// Step 2: Use the reqId to send animation data
+avatarView.avatarController.yieldFramesData(keyframes, reqId)
+```
+
+**Why reqId 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
@@ -380,9 +420,10 @@ avatarView.avatarController.onError = (error: Error) => {}
 
 **Important Notes:**
 - `start()` and `close()` are only available in network mode
-- `play()`, `sendAudioChunk()`, and `sendKeyframes()` are only available in external data mode
+- `playback()`, `yieldAudioData()`, and `yieldFramesData()` are only available in external data mode
 - `pause()`, `resume()`, `interrupt()`, and `clear()` are available in both modes
 - The playback mode is determined when creating `AvatarView` and cannot be changed
+- **Request ID (reqId)**: In external data mode, always send audio data first to obtain a reqId, then use that reqId when sending animation data. Animation data with mismatched reqId will be discarded.
 
 ## 🔧 Configuration
 
@@ -391,11 +432,15 @@ avatarView.avatarController.onError = (error: Error) => {}
 ```typescript
 interface Configuration {
   environment: Environment
+  drivingServiceMode?: DrivingServiceMode  // Optional, default is 'sdk' (network mode)
 }
 ```
 
 **Description:**
 - `environment`: Specifies the environment (cn/us/test), SDK will automatically use the corresponding API address and WebSocket address based on the environment
+- `drivingServiceMode`: Specifies the driving service mode
+  - `DrivingServiceMode.sdk` (default): SDK mode - SDK handles WebSocket communication automatically
+  - `DrivingServiceMode.host`: Host mode - Host application provides audio and animation data
 - `sessionToken`: Set separately via `AvatarKit.setSessionToken()`, not in Configuration
 
 ```typescript
@@ -406,22 +451,20 @@ enum Environment {
 }
 ```
 
-### AvatarViewOptions
+### AvatarView Constructor
 
 ```typescript
-interface AvatarViewOptions {
-  playbackMode?: AvatarPlaybackMode  // Playback mode, default is 'network'
-  container?: HTMLElement            // Canvas container element
-}
+constructor(avatar: Avatar, container: HTMLElement)
 ```
 
-**Description:**
-- `playbackMode`: Specifies the playback mode (`'network'` or `'external'`), default is `'network'`
-  - `'network'`: SDK handles WebSocket communication, send audio via `send()`
-  - `'external'`: External components provide audio and animation data, SDK handles synchronized playback
-- `container`: Optional container element for Canvas, if not provided, Canvas will be created but not added to DOM
-  - Canvas automatically uses the container's full dimensions (width and height)
-  - Canvas aspect ratio adapts to container size - set container dimensions to control the aspect ratio
+**Parameters:**
+- `avatar`: Avatar 实例
+- `container`: Canvas 容器元素（必选）
+  - Canvas 自动使用容器的完整尺寸（宽度和高度）
+  - Canvas 宽高比适应容器尺寸 - 设置容器尺寸以控制宽高比
+  - Canvas 会自动添加到容器中
+
+**Note:** 播放模式由 `AvatarKit.initialize()` 配置中的 `drivingServiceMode` 决定，而不是在构造函数参数中
   - SDK automatically handles resize events via ResizeObserver
 
 ```typescript
@@ -516,8 +559,7 @@ avatarView.avatarController.onError = (error: Error) => {
 ```typescript
 // Initialize
 const container = document.getElementById('avatar-container')
-const avatarView = new AvatarView(avatar, {
-  container: container,
+const avatarView = new AvatarView(avatar, container)
   playbackMode: AvatarPlaybackMode.network
 })
 await avatarView.avatarController.start()
@@ -535,16 +577,16 @@ avatarView.dispose() // Automatically cleans up all resources
 ```typescript
 // Initialize
 const container = document.getElementById('avatar-container')
-const avatarView = new AvatarView(avatar, {
-  container: container,
-  playbackMode: AvatarPlaybackMode.external
-})
+const avatarView = new AvatarView(avatar, container)
 
 // Use
 const initialAudioChunks = [{ data: audioData1, isLast: false }]
-await avatarView.avatarController.play(initialAudioChunks, initialKeyframes)
-avatarView.avatarController.sendAudioChunk(audioChunk, false)
-avatarView.avatarController.sendKeyframes(keyframes)
+// Step 1: Send audio first to get reqId
+const reqId = await avatarView.avatarController.playback(initialAudioChunks, initialKeyframes)
+// Step 2: Stream additional audio (returns reqId)
+const currentReqId = avatarView.avatarController.yieldAudioData(audioChunk, false)
+// Step 3: Use reqId to send animation data (mismatched reqId will be discarded)
+avatarView.avatarController.yieldFramesData(keyframes, currentReqId || reqId)
 
 // Cleanup
 avatarView.avatarController.clear() // Clear all data and resources
@@ -583,7 +625,7 @@ The `send()` method receives audio data in `ArrayBuffer` format:
 
 #### External Data Mode
 
-The `play()` method starts playback with initial data, then use `sendAudioChunk()` to stream additional audio:
+The `playback()` method starts playback with existing audio and animation data, generating a new reqId and interrupting any existing conversation. Then use `yieldAudioData()` to stream additional audio:
 
 **Audio Format Requirements:**
 - Same as network mode: 16kHz mono PCM16 format
@@ -591,18 +633,25 @@ The `play()` method starts playback with initial data, then use `sendAudioChunk(
 
 **Usage:**
 ```typescript
-// Start playback with initial audio and animation data
+// 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 }
 ]
-await avatarController.play(initialAudioChunks, initialKeyframes)
+const reqId = await avatarController.playback(initialAudioChunks, initialKeyframes)
+// Returns: reqId - New request ID for this conversation session
 
 // Stream additional audio chunks
-avatarController.sendAudioChunk(audioChunk, isLast)
+const reqId = avatarController.yieldAudioData(audioChunk, isLast)
+// Returns: reqId - Request ID for this audio session
 ```
 
+**⚠️ Request ID Workflow:**
+1. **Send audio first** → Get reqId from `playback()` or `yieldAudioData()`
+2. **Send animation with reqId** → Use the reqId from step 1 in `yieldFramesData()`
+3. **Data matching** → Only animation data with matching reqId 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

package/dist/{StreamingAudioPlayer-COgQTrz3.js → StreamingAudioPlayer-a8MwHQ3Q.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 i = (h, t, e) => g(h, typeof t != "symbol" ? t + "" : t, e);
-import { A as m, e as f, a as c, l as u } from "./index-Dsokgngg.js";
+import { A as m, e as f, a as c, l as u } from "./index-suaZGA5u.js";
 class y {
   constructor(t) {
     // AudioContext is managed internally
@@ -331,4 +331,4 @@ class y {
 export {
   y as StreamingAudioPlayer
 };
-//# sourceMappingURL=StreamingAudioPlayer-COgQTrz3.js.map
+//# sourceMappingURL=StreamingAudioPlayer-a8MwHQ3Q.js.map

package/dist/{StreamingAudioPlayer-COgQTrz3.js.map → StreamingAudioPlayer-a8MwHQ3Q.js.map}

@@ -1 +1 @@
-{"version":3,"file":"StreamingAudioPlayer-COgQTrz3.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  // 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 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      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.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    }\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   * 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","data"],"mappings":"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"}
+{"version":3,"file":"StreamingAudioPlayer-a8MwHQ3Q.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  // 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 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      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.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    }\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   * 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","data"],"mappings":"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"}