@mingxy/ocosay 1.0.20 → 1.0.22

package/README.md

@@ -28,9 +28,23 @@
 
 | 平台 | 支持状态 | 说明 |
 |------|----------|------|
-| macOS | ✅ 完全支持 | Darwin 架构，native 播放 |
-| Linux | ✅ 完全支持 | 需安装 mpv/libuv |
-| Windows | ⚠️ 部分支持 | WSL 环境推荐 |
+| macOS | ✅ 完全支持 | howler.js 跨平台音频后端 |
+| Linux | ✅ 完全支持 | howler.js 跨平台音频后端 |
+| Windows | ✅ 完全支持 | howler.js 跨平台音频后端 |
+
+### 音频后端
+
+ocosay 使用统一的 `AudioBackend` 架构：
+
+| 后端 | 类型 | 说明 |
+|------|------|------|
+| **howler** | 跨平台 | 基于 howler.js，纯 JavaScript 实现，npm 直接安装无需编译 |
+| naudiodon | 流式 | native 模块，支持真正的流式播放（需 npm install） |
+| afplay | macOS | 系统命令 afplay |
+| aplay | Linux | 系统命令 aplay |
+| powershell | Windows | PowerShell PlaySync |
+
+> **注意**: 流式播放（豆包模式）需要 naudiodon 后端支持。请执行 `npm install naudiodon` 安装。
 
 ## 安装方式
 

package/dist/core/backends/howler-backend.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Howler.js Backend - 基于 howler.js 的跨平台音频播放后端
+ * 支持流式播放（边收边播）
+ */
+import { AudioBackend, BackendOptions } from './base';
+export declare class HowlerBackend implements AudioBackend {
+    readonly name = "howler";
+    readonly supportsStreaming = false;
+    private howl;
+    private events?;
+    private _started;
+    private _paused;
+    private _stopped;
+    private volume;
+    private bytesWritten;
+    private blobUrl;
+    private format;
+    constructor(options?: BackendOptions);
+    start(_filePath: string): void;
+    write(chunk: Buffer): void;
+    end(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    getCurrentTime(): number | undefined;
+    getDuration(): number | undefined;
+    setVolume(volume: number): void;
+    destroy(): void;
+    private handleError;
+}
+//# sourceMappingURL=howler-backend.d.ts.map

package/dist/core/backends/howler-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"howler-backend.d.ts","sourceRoot":"","sources":["../../../src/core/backends/howler-backend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAsB,cAAc,EAAE,MAAM,QAAQ,CAAA;AAEzE,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,iBAAiB,SAAQ;IAElC,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAwB;gBAE1B,OAAO,GAAE,cAAmB;IAMxC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAyC9B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA6D1B,GAAG,IAAI,IAAI;IAIX,KAAK,IAAI,IAAI;IAUb,MAAM,IAAI,IAAI;IAUd,IAAI,IAAI,IAAI;IAwBZ,cAAc,IAAI,MAAM,GAAG,SAAS;IAOpC,WAAW,IAAI,MAAM,GAAG,SAAS;IAOjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,WAAW;CAGpB"}

package/dist/core/backends/howler-backend.js

@@ -0,0 +1,183 @@
+/**
+ * Howler.js Backend - 基于 howler.js 的跨平台音频播放后端
+ * 支持流式播放（边收边播）
+ */
+import { Howl } from 'howler';
+export class HowlerBackend {
+    name = 'howler';
+    supportsStreaming = false; // Howler.js 不支持真正的流式播放
+    howl = null;
+    events;
+    _started = false;
+    _paused = false;
+    _stopped = false;
+    volume = 1.0;
+    bytesWritten = 0;
+    blobUrl = null;
+    format;
+    constructor(options = {}) {
+        this.events = options.events;
+        this.volume = options.volume ?? 1.0;
+        this.format = options.format || 'mp3';
+    }
+    start(_filePath) {
+        if (this._started) {
+            this.stop();
+        }
+        this._started = true;
+        this._stopped = false;
+        this._paused = false;
+        this.bytesWritten = 0;
+        // 创建空的 Howl 对象，稍后通过流式数据填充
+        this.howl = new Howl({
+            src: [''], // 初始为空
+            html5: true, // 启用 HTML5 Audio 模式支持流式
+            volume: this.volume,
+            format: [this.format],
+            onplay: () => {
+                this.events?.onStart?.();
+            },
+            onpause: () => {
+                if (!this._stopped) {
+                    this.events?.onPause?.();
+                }
+            },
+            onstop: () => {
+                if (!this._stopped) {
+                    this.events?.onStop?.();
+                }
+            },
+            onend: () => {
+                this.events?.onEnd?.();
+            },
+            onloaderror: (_id, error) => {
+                this.handleError(new Error(`Howler load error: ${error}`));
+            },
+            onplayerror: (_id, error) => {
+                this.handleError(new Error(`Howler play error: ${error}`));
+            }
+        });
+    }
+    write(chunk) {
+        if (!this._started || this._stopped)
+            return;
+        if (!this.howl)
+            return;
+        this.bytesWritten += chunk.length;
+        this.events?.onProgress?.(this.bytesWritten);
+        // Howler 不支持直接 Buffer 流式写入
+        // 对于流式播放，我们创建 Blob URL 并重新加载
+        const blob = new Blob([chunk], { type: `audio/${this.format}` });
+        // 清理旧的 blob URL
+        if (this.blobUrl) {
+            URL.revokeObjectURL(this.blobUrl);
+        }
+        this.blobUrl = URL.createObjectURL(blob);
+        // 停止当前播放并重新加载
+        const wasPlaying = this.howl.playing();
+        this.howl.stop();
+        this.howl.unload();
+        // 创建新的 Howl 实例
+        this.howl = new Howl({
+            src: [this.blobUrl],
+            html5: true,
+            volume: this.volume,
+            format: [this.format],
+            onplay: () => {
+                if (!wasPlaying) {
+                    this.events?.onStart?.();
+                }
+            },
+            onpause: () => {
+                if (!this._stopped) {
+                    this.events?.onPause?.();
+                }
+            },
+            onstop: () => {
+                if (!this._stopped) {
+                    this.events?.onStop?.();
+                }
+            },
+            onend: () => {
+                this.events?.onEnd?.();
+            },
+            onloaderror: (_id, error) => {
+                this.handleError(new Error(`Howler load error: ${error}`));
+            },
+            onplayerror: (_id, error) => {
+                this.handleError(new Error(`Howler play error: ${error}`));
+            }
+        });
+        // 如果之前在播放或者需要自动播放
+        if (wasPlaying || this._started) {
+            this.howl.play();
+        }
+    }
+    end() {
+        // 流式写入结束，不停止播放，让其播完
+    }
+    pause() {
+        if (!this._started || this._paused || this._stopped)
+            return;
+        if (this.howl && this.howl.playing()) {
+            this.howl.pause();
+            this._paused = true;
+            this.events?.onPause?.();
+        }
+    }
+    resume() {
+        if (!this._paused || this._stopped)
+            return;
+        if (this.howl) {
+            this.howl.play();
+            this._paused = false;
+            this.events?.onResume?.();
+        }
+    }
+    stop() {
+        this._stopped = true;
+        this._started = false;
+        this._paused = false;
+        if (this.howl) {
+            try {
+                this.howl.stop();
+                this.howl.unload();
+            }
+            catch (e) {
+                // 忽略停止错误
+            }
+            this.howl = null;
+        }
+        if (this.blobUrl) {
+            URL.revokeObjectURL(this.blobUrl);
+            this.blobUrl = null;
+        }
+        this.bytesWritten = 0;
+        this.events?.onStop?.();
+    }
+    getCurrentTime() {
+        if (this.howl) {
+            return this.howl.seek();
+        }
+        return undefined;
+    }
+    getDuration() {
+        if (this.howl) {
+            return this.howl.duration();
+        }
+        return undefined;
+    }
+    setVolume(volume) {
+        this.volume = Math.max(0, Math.min(1, volume));
+        if (this.howl) {
+            this.howl.volume(this.volume);
+        }
+    }
+    destroy() {
+        this.stop();
+    }
+    handleError(error) {
+        this.events?.onError?.(error);
+    }
+}
+//# sourceMappingURL=howler-backend.js.map

package/dist/core/backends/howler-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"howler-backend.js","sourceRoot":"","sources":["../../../src/core/backends/howler-backend.ts"],"names":[],"mappings":"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"}

package/dist/core/backends/index.d.ts

@@ -6,6 +6,7 @@ export { NaudiodonBackend } from './naudiodon-backend';
 export { AfplayBackend } from './afplay-backend';
 export { AplayBackend } from './aplay-backend';
 export { PowerShellBackend } from './powershell-backend';
+export { HowlerBackend } from './howler-backend';
 import { AudioBackend, BackendOptions } from './base';
 /**
  * 后端类型枚举
@@ -15,6 +16,7 @@ export declare enum BackendType {
     AFPLAY = "afplay",
     APLAY = "aplay",
     POWERSHELL = "powershell",
+    HOWLER = "howler",
     AUTO = "auto"
 }
 export declare function isWsl(): boolean;

package/dist/core/backends/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAMrD;;GAEG;AACH,oBAAY,WAAW;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AA0BD,wBAAgB,KAAK,IAAI,OAAO,CAO/B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAA8B,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CA6B9G;AAiBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAK5D;AAED,wBAAgB,qBAAqB,IAAI,WAAW,CAiBnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/backends/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAGzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAOrD;;GAEG;AACH,oBAAY,WAAW;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AA0BD,wBAAgB,KAAK,IAAI,OAAO,CAO/B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAA8B,EAAE,OAAO,GAAE,cAAmB,GAAG,YAAY,CA6B9G;AAmBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAK5D;AAED,wBAAgB,qBAAqB,IAAI,WAAW,CAiBnD"}

package/dist/core/backends/index.js

@@ -6,10 +6,12 @@ export { NaudiodonBackend } from './naudiodon-backend';
 export { AfplayBackend } from './afplay-backend';
 export { AplayBackend } from './aplay-backend';
 export { PowerShellBackend } from './powershell-backend';
+export { HowlerBackend } from './howler-backend';
 import { NaudiodonBackend } from './naudiodon-backend';
 import { AfplayBackend } from './afplay-backend';
 import { AplayBackend } from './aplay-backend';
 import { PowerShellBackend } from './powershell-backend';
+import { HowlerBackend } from './howler-backend';
 /**
  * 后端类型枚举
  */
@@ -19,6 +21,7 @@ export var BackendType;
     BackendType["AFPLAY"] = "afplay";
     BackendType["APLAY"] = "aplay";
     BackendType["POWERSHELL"] = "powershell";
+    BackendType["HOWLER"] = "howler";
     BackendType["AUTO"] = "auto";
 })(BackendType || (BackendType = {}));
 let naudiodonCache = null;
@@ -98,6 +101,8 @@ function createBackendByType(type, options) {
             return new AplayBackend(options);
         case BackendType.POWERSHELL:
             return new PowerShellBackend(options);
+        case BackendType.HOWLER:
+            return new HowlerBackend(options);
         default:
             throw new Error(`Unknown backend type: ${type}`);
     }

package/dist/core/backends/index.js.map

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

package/dist/core/player.d.ts

@@ -37,7 +37,7 @@ export declare class AudioPlayer extends EventEmitter implements Player {
     protected events?: PlayerEvents | undefined;
     private _playing;
     private _paused;
-    private currentProcess?;
+    private backend;
     private currentFile?;
     constructor(events?: PlayerEvents | undefined);
     /**
@@ -48,21 +48,11 @@ export declare class AudioPlayer extends EventEmitter implements Player {
     play(audioData: Buffer | ReadableStream, format: string): Promise<void>;
     /**
      * 播放音频文件
-     * 优先使用 afplay (macOS), aplay (Linux), 否则用 PowerShell (Windows)
+     * 使用 AudioBackend 统一后端播放
      */
     private playFile;
-    /**
-     * 暂停播放
-     * 注意: 目前通过 SIGSTOP 实现，真正的 pause 需要支持暂停的音频库
-     */
     pause(): void;
-    /**
-     * 恢复播放
-     */
     resume(): void;
-    /**
-     * 停止播放
-     */
     stop(): Promise<void>;
     /**
      * 是否正在播放

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

@@ -1 +1 @@
-{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAQrC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACnE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,KAAK,IAAI,IAAI,CAAA;IACb,MAAM,IAAI,IAAI,CAAA;IACd,IAAI,IAAI,IAAI,CAAA;IACZ,SAAS,IAAI,OAAO,CAAA;IACpB,QAAQ,IAAI,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAa,YAAW,MAAM;IAMjD,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY;IAL3C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,cAAc,CAAC,CAAc;IACrC,OAAO,CAAC,WAAW,CAAC,CAAQ;gBAEN,MAAM,CAAC,EAAE,YAAY,YAAA;IAI3C;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE7E;;;OAGG;IACH,OAAO,CAAC,QAAQ;IA2ChB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,MAAM,IAAI,IAAI;IAed;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,OAAO,CAAC,OAAO;CAYhB;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAI;gBAEd,MAAM,CAAC,EAAE,YAAY;IAIjC;;;;;OAKG;IACG,aAAa,CACjB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;CAoCjB;AAED,eAAe,WAAW,CAAA"}
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AASrC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACnE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvE,KAAK,IAAI,IAAI,CAAA;IACb,MAAM,IAAI,IAAI,CAAA;IACd,IAAI,IAAI,IAAI,CAAA;IACZ,SAAS,IAAI,OAAO,CAAA;IACpB,QAAQ,IAAI,OAAO,CAAA;CACpB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAa,YAAW,MAAM;IAMjD,SAAS,CAAC,MAAM,CAAC,EAAE,YAAY;IAL3C,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAQ;gBAEN,MAAM,CAAC,EAAE,YAAY,YAAA;IAwC3C;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE7E;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAOhB,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,IAAI;IAMR,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,OAAO,CAAC,OAAO;CAYhB;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAI;gBAEd,MAAM,CAAC,EAAE,YAAY;IAIjC;;;;;OAKG;IACG,aAAa,CACjB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;CAoCjB;AAED,eAAe,WAAW,CAAA"}

package/dist/core/player.js

@@ -3,12 +3,12 @@
  * 音频播放引擎 - 支持 pause/resume/stop 和流式播放
  */
 import { EventEmitter } from 'events';
-import { spawn } from 'child_process';
 import fs from 'fs';
 import { createWriteStream } from 'fs';
 import { tmpdir } from 'os';
 import { join } from 'path';
 import { TTSError, TTSErrorCode } from './types';
+import { createBackend, BackendType } from './backends';
 /**
  * AudioPlayer - 基于系统播放器的音频播放实现
  * 支持 macOS (afplay), Linux (aplay), Windows (PowerShell)
@@ -17,11 +17,43 @@ export class AudioPlayer extends EventEmitter {
     events;
     _playing = false;
     _paused = false;
-    currentProcess;
+    backend;
     currentFile;
     constructor(events) {
         super();
         this.events = events;
+        this.backend = createBackend(BackendType.AUTO, {
+            events: {
+                onStart: () => {
+                    this.events?.onStart?.();
+                    this.emit('start');
+                },
+                onEnd: () => {
+                    this._playing = false;
+                    this.events?.onEnd?.();
+                    this.emit('end');
+                    this.cleanup();
+                },
+                onError: (error) => {
+                    this._playing = false;
+                    const ttsError = new TTSError(error.message || 'Playback failed', TTSErrorCode.PLAYER_ERROR, 'player');
+                    this.events?.onError?.(ttsError);
+                    this.emit('error', ttsError);
+                },
+                onPause: () => {
+                    this.events?.onPause?.();
+                    this.emit('pause');
+                },
+                onResume: () => {
+                    this.events?.onResume?.();
+                    this.emit('resume');
+                },
+                onStop: () => {
+                    this.events?.onStop?.();
+                    this.emit('stop');
+                }
+            }
+        });
     }
     /**
      * 播放音频
@@ -86,104 +118,31 @@ export class AudioPlayer extends EventEmitter {
     }
     /**
      * 播放音频文件
-     * 优先使用 afplay (macOS), aplay (Linux), 否则用 PowerShell (Windows)
+     * 使用 AudioBackend 统一后端播放
      */
-    playFile(filePath, format) {
-        const platform = process.platform;
-        return new Promise((resolve, reject) => {
-            let command;
-            let args;
-            if (platform === 'darwin') {
-                // macOS
-                command = 'afplay';
-                args = [filePath];
-            }
-            else if (platform === 'linux') {
-                // Linux
-                command = 'aplay';
-                args = [filePath];
-            }
-            else {
-                // Windows 或其他
-                command = 'powershell';
-                args = ['-c', `(New-Object System.Media.SoundPlayer('${filePath.replace(/\\/g, '\\\\')}')).PlaySync()`];
-            }
-            this.currentProcess = spawn(command, args, {
-                stdio: 'ignore',
-                detached: false
-            });
-            this.currentProcess.on('exit', (code, signal) => {
-                // 如果是被信号终止（如 SIGTERM），不当作错误
-                if (signal === 'SIGTERM' || signal === 'SIGINT') {
-                    resolve();
-                }
-                else if (code === 0) {
-                    resolve();
-                }
-                else {
-                    reject(new Error(`Player exited with code ${code}`));
-                }
-            });
-            this.currentProcess.on('error', (error) => {
-                reject(error);
-            });
+    playFile(filePath, _format) {
+        return new Promise((resolve) => {
+            this.backend.start(filePath);
+            resolve(); // backend.start() 是同步的，立即 resolve
         });
     }
-    /**
-     * 暂停播放
-     * 注意: 目前通过 SIGSTOP 实现，真正的 pause 需要支持暂停的音频库
-     */
     pause() {
         if (!this._playing || this._paused)
             return;
-        if (this.currentProcess) {
-            try {
-                this.currentProcess.kill('SIGSTOP');
-                this._paused = true;
-                this.events?.onPause?.();
-                this.emit('pause');
-            }
-            catch (e) {
-                // 如果 kill 失败，忽略
-            }
-        }
+        this.backend.pause();
+        this._paused = true;
     }
-    /**
-     * 恢复播放
-     */
     resume() {
         if (!this._playing || !this._paused)
             return;
-        if (this.currentProcess) {
-            try {
-                this.currentProcess.kill('SIGCONT');
-                this._paused = false;
-                this.events?.onResume?.();
-                this.emit('resume');
-            }
-            catch (e) {
-                // 如果 kill 失败，忽略
-            }
-        }
+        this.backend.resume();
+        this._paused = false;
     }
-    /**
-     * 停止播放
-     */
     async stop() {
         this._playing = false;
         this._paused = false;
-        if (this.currentProcess) {
-            try {
-                this.currentProcess.kill('SIGTERM');
-            }
-            catch (e) {
-                // 忽略错误
-            }
-            this.currentProcess = undefined;
-        }
+        this.backend.stop();
         this.cleanup();
-        this.events?.onStop?.();
-        this.emit('stop');
     }
     /**
      * 是否正在播放

package/dist/core/player.js.map

@@ -1 +1 @@
-{"version":3,"file":"player.js","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"player.js","sourceRoot":"","sources":["../../src/core/player.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAA;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA4BvD;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,YAAY;IAMrB;IALd,QAAQ,GAAG,KAAK,CAAA;IAChB,OAAO,GAAG,KAAK,CAAA;IACf,OAAO,CAAc;IACrB,WAAW,CAAS;IAE5B,YAAsB,MAAqB;QACzC,KAAK,EAAE,CAAA;QADa,WAAM,GAAN,MAAM,CAAe;QAEzC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE;YAC7C,MAAM,EAAE;gBACN,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;oBACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACpB,CAAC;gBACD,KAAK,EAAE,GAAG,EAAE;oBACV,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;oBACrB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAA;oBACtB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;oBAChB,IAAI,CAAC,OAAO,EAAE,CAAA;gBAChB,CAAC;gBACD,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;oBACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;oBACrB,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAC3B,KAAK,CAAC,OAAO,IAAI,iBAAiB,EAClC,YAAY,CAAC,YAAY,EACzB,QAAQ,CACT,CAAA;oBACD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAA;oBAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;gBAC9B,CAAC;gBACD,OAAO,EAAE,GAAG,EAAE;oBACZ,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;oBACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACpB,CAAC;gBACD,QAAQ,EAAE,GAAG,EAAE;oBACb,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAA;oBACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBACrB,CAAC;gBACD,MAAM,EAAE,GAAG,EAAE;oBACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAA;oBACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACnB,CAAC;aACF;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,SAAkC,EAAE,MAAc;QAC3D,aAAa;QACb,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACnB,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QAEpB,IAAI,CAAC;YACH,cAAc;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,IAAI,CAAC,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC,CAAA;YACjE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAA;YAE3B,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;YACvC,CAAC;iBAAM,CAAC;gBACN,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;gBAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAA;gBAEpC,IAAI,CAAC;oBACH,OAAO,IAAI,EAAE,CAAC;wBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;wBAC3C,IAAI,IAAI;4BAAE,MAAK;wBACf,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;4BAChC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;wBACvC,CAAC;oBACH,CAAC;oBACD,WAAW,CAAC,GAAG,EAAE,CAAA;gBACnB,CAAC;wBAAS,CAAC;oBACT,MAAM,CAAC,WAAW,EAAE,CAAA;gBACtB,CAAC;gBAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC1C,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;oBACjC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBACjC,CAAC,CAAC,CAAA;YACJ,CAAC;YAED,SAAS;YACT,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;YACxB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAElB,YAAY;YACZ,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAErC,OAAO;YACP,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;YACrB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAA;YACtB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAEhB,SAAS;YACT,IAAI,CAAC,OAAO,EAAE,CAAA;QAEhB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;YACrB,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAC3B,KAAK,CAAC,OAAO,IAAI,iBAAiB,EAClC,YAAY,CAAC,YAAY,EACzB,QAAQ,CACT,CAAA;YACD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAA;YAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;YAC5B,MAAM,QAAQ,CAAA;QAChB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,QAAQ,CAAC,QAAgB,EAAE,OAAe;QAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC5B,OAAO,EAAE,CAAA,CAAC,kCAAkC;QAC9C,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;IACrB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAC3C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACpB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QACnB,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;OAEG;IACK,OAAO;QACb,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;oBACpC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBACjC,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,SAAS,CAAA;QAC9B,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACtC,MAAM,GAAa,EAAE,CAAA;IACrB,cAAc,GAAG,CAAC,CAAA;IAE1B,YAAY,MAAqB;QAC/B,KAAK,CAAC,MAAM,CAAC,CAAA;IACf,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CACjB,MAAsB,EACtB,MAAc,EACd,YAAqB;QAErB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;QAEjC,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;gBAC3C,IAAI,IAAI;oBAAE,MAAK;gBAEf,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;oBAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;oBACvB,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,MAAM,CAAA;oBAEnC,SAAS;oBACT,IAAI,YAAY,EAAE,CAAC;wBACjB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;4BACpB,OAAO,EAAE,IAAI,CAAC,cAAc;4BAC5B,KAAK,EAAE,YAAY;yBACpB,CAAC,CAAA;wBACF,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;4BACxB,OAAO,EAAE,IAAI,CAAC,cAAc;4BAC5B,KAAK,EAAE,YAAY;yBACpB,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,iBAAiB;YACjB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QAEpC,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAA;YACpB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;YAChB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAA;QACzB,CAAC;IACH,CAAC;CACF;AAED,eAAe,WAAW,CAAA"}

package/dist/core/stream-player.d.ts

@@ -1,8 +1,9 @@
 /**
  * StreamPlayer - 真正的边收边播流式音频播放器
- * 接收音频 chunk，同时写入临时文件并立即启动播放器播放
+ * 使用 AudioBackend 实现真正的流式播放（不写临时文件）
  */
 import { EventEmitter } from 'events';
+import { BackendType } from './backends';
 /**
  * StreamPlayer Events - 流式播放器事件回调接口
  */
@@ -21,19 +22,18 @@ export interface StreamPlayerEvents {
 export interface StreamPlayerOptions {
     format?: 'mp3' | 'wav' | 'flac';
     events?: StreamPlayerEvents;
+    backendType?: BackendType;
 }
 /**
  * StreamPlayer - 边收边播的流式音频播放器
  *
  * 特性：
- * - 写入临时文件的同时立即启动播放器
+ * - 使用 AudioBackend 实现真正的边收边播
+ * - 不写临时文件，直接流式播放
  * - 支持 pause/resume/stop 控制
- * - 跨平台支持：macOS (afplay), Linux (aplay), Windows (PowerShell)
  */
 export declare class StreamPlayer extends EventEmitter {
-    private tempFile;
-    private writeStream?;
-    private playerProcess?;
+    private backend;
     private _bytesWritten;
     private _started;
     private _paused;
@@ -43,31 +43,26 @@ export declare class StreamPlayer extends EventEmitter {
     constructor(options?: StreamPlayerOptions);
     /**
      * 开始播放
-     * 创建临时文件，创建写入流，启动播放器进程
+     * 初始化后端，准备接收音频数据
      */
     start(): void;
     /**
-     * 启动播放器进程
-     */
-    private startPlayer;
-    /**
-     * 写入音频数据块（边收边写）
+     * 写入音频数据块（边收边播）
      * 如果尚未 start()，会自动调用
      */
     write(chunk: Buffer): void;
     /**
      * 结束写入
-     * 关闭写入流，但不杀播放器进程，让它播完
+     * 通知后端写入完成，但保持播放直到结束
      */
     end(): void;
     /**
      * 停止播放
-     * 杀死播放器进程，删除临时文件
+     * 立即停止播放并释放资源
      */
     stop(): void;
     /**
      * 暂停播放
-     * 使用 SIGSTOP 暂停播放器进程
      */
     pause(): void;
     /**
@@ -90,18 +85,10 @@ export declare class StreamPlayer extends EventEmitter {
      * 获取已写入的字节数
      */
     getBytesWritten(): number;
-    /**
-     * 获取临时文件路径
-     */
-    getTempFile(): string;
     /**
      * 处理错误
      */
     private handleError;
-    /**
-     * 删除临时文件
-     */
-    private deleteTempFile;
 }
 export default StreamPlayer;
 //# sourceMappingURL=stream-player.d.ts.map