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

package/dist/audio/AnimationPlayer.d.ts

@@ -52,6 +52,24 @@ export declare class AnimationPlayer {
      * 添加音频块（仅用于流式播放）
      */
     addAudioChunk(audio: Uint8Array, isLast?: boolean): void;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 继续播放
+     */
+    resume(): Promise<void>;
+    /**
+     * 设置音量 (0.0 - 1.0)
+     * 注意：这仅控制数字人音频播放器的音量，不影响系统音量
+     * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）
+     */
+    setVolume(volume: number): void;
+    /**
+     * 获取当前音量
+     * @returns 当前音量值 (0.0 - 1.0)
+     */
+    getVolume(): number;
     dispose(): void;
 }
-//# sourceMappingURL=AnimationPlayer.d.ts.map

package/dist/audio/StreamingAudioPlayer.d.ts

@@ -17,19 +17,38 @@ export declare class StreamingAudioPlayer {
     private sessionStartTime;
     private pausedTimeOffset;
     private pausedAt;
+    private pausedAudioContextTime;
     private scheduledTime;
     private isPlaying;
     private isPaused;
     private autoStartEnabled;
+    private autoContinue;
     private audioChunks;
     private scheduledChunks;
     private activeSources;
+    private lastScheduledChunkEndTime;
+    private lastGetCurrentTimeLog;
+    private scheduledChunkInfo;
+    private gainNode;
+    private volume;
     private onEndedCallback?;
+    private stateChangeHandler?;
+    private isResuming;
     constructor(options?: StreamingAudioPlayerOptions);
     /**
      * Initialize audio context (create and ensure it's ready)
      */
     initialize(): Promise<void>;
+    /**
+     * 确保 AudioContext 正在运行（如果被暂停则自动恢复）
+     * 只在正在播放且未暂停时自动恢复，避免干扰正常的暂停/恢复逻辑
+     *
+     * 优化：
+     * - 快速路径：如果已经是 running 状态，直接返回
+     * - 避免并发恢复：使用 isResuming 标志防止重复恢复请求
+     * - 处理 closed 状态：如果 AudioContext 已关闭，无法恢复
+     */
+    private ensureAudioContextRunning;
     /**
      * Add audio chunk (16-bit PCM)
      */
@@ -60,8 +79,19 @@ export declare class StreamingAudioPlayer {
     private pcmToAudioBuffer;
     /**
      * Get current playback time (seconds)
+     * 返回实际播放的音频总时长
      */
     getCurrentTime(): number;
+    /**
+     * Get total duration of buffered audio (seconds)
+     * 计算所有已缓冲 chunk 的总时长
+     */
+    getBufferedDuration(): number;
+    /**
+     * Get current AudioContext time
+     * @returns Current AudioContext time in seconds, or 0 if AudioContext is not initialized
+     */
+    getAudioContextTime(): number;
     /**
      * Pause playback
      */
@@ -95,14 +125,6 @@ export declare class StreamingAudioPlayer {
      * Check if playing
      */
     isPlayingNow(): boolean;
-    /**
-     * Get total duration of buffered audio
-     */
-    getBufferedDuration(): number;
-    /**
-     * Get remaining duration (buffered - played) in seconds
-     */
-    getRemainingDuration(): number;
     /**
      * Dispose and cleanup
      */
@@ -115,9 +137,19 @@ export declare class StreamingAudioPlayer {
     flush(options?: {
         hard?: boolean;
     }): void;
+    /**
+     * 设置音量 (0.0 - 1.0)
+     * 注意：这仅控制数字人音频播放器的音量，不影响系统音量
+     * @param volume 音量值，范围 0.0 到 1.0（0.0 为静音，1.0 为最大音量）
+     */
+    setVolume(volume: number): void;
+    /**
+     * 获取当前音量
+     * @returns 当前音量值 (0.0 - 1.0)
+     */
+    getVolume(): number;
     /**
      * Debug logging
      */
     private log;
 }
-//# sourceMappingURL=StreamingAudioPlayer.d.ts.map