@mingxy/ocosay 1.0.0

package/dist/core/speaker.js

@@ -0,0 +1,218 @@
+/**
+ * Speaker - TTS 统一调用入口
+ * 提供简洁的 API 和便捷函数
+ */
+import { EventEmitter } from 'events';
+import { TTSError, TTSErrorCode } from './types';
+import { getProvider, listProviders, hasProvider } from '../providers/base';
+import { AudioPlayer } from './player';
+/**
+ * Speaker - TTS 统一调用入口类
+ * 封装 Provider 和 Player，提供简洁的 speak/pause/resume/stop API
+ */
+export class Speaker extends EventEmitter {
+    options;
+    currentProvider;
+    player;
+    currentText;
+    isSpeaking = false;
+    isPaused = false;
+    constructor(options = {}) {
+        super();
+        this.options = options;
+        // 初始化播放器
+        const playerEvents = {
+            onStart: () => this.emit('start', this.currentText),
+            onEnd: () => {
+                this.isSpeaking = false;
+                this.emit('end', this.currentText);
+            },
+            onError: (error) => this.emit('error', error),
+            onPause: () => {
+                this.isPaused = true;
+                this.emit('pause');
+            },
+            onResume: () => {
+                this.isPaused = false;
+                this.emit('resume');
+            },
+            onStop: () => {
+                this.isSpeaking = false;
+                this.isPaused = false;
+                this.emit('stop');
+            }
+        };
+        this.player = new AudioPlayer(playerEvents);
+    }
+    /**
+     * 说话 - 核心方法
+     * @param text 要说的文本
+     * @param options 可选参数
+     */
+    async speak(text, options = {}) {
+        // 参数校验
+        if (!text || text.trim().length === 0) {
+            throw new TTSError('Text cannot be empty', TTSErrorCode.INVALID_PARAMS, 'speaker');
+        }
+        // 停止当前播放
+        if (this.isSpeaking) {
+            await this.stop();
+        }
+        this.isSpeaking = true;
+        this.currentText = text;
+        try {
+            // 获取 provider
+            const providerName = options.provider || this.options.defaultProvider || 'minimax';
+            if (!hasProvider(providerName)) {
+                throw new TTSError(`Provider "${providerName}" not found`, TTSErrorCode.UNKNOWN, 'speaker');
+            }
+            this.currentProvider = getProvider(providerName);
+            // 调用 provider 生成音频
+            const result = await this.currentProvider.speak(text, {
+                model: options.model || this.options.defaultModel || 'stream',
+                voice: options.voice || this.options.defaultVoice,
+                speed: options.speed,
+                volume: options.volume,
+                pitch: options.pitch,
+                sourceVoice: options.sourceVoice
+            });
+            // 播放音频
+            if (this.player) {
+                await this.player.play(result.audioData, result.format);
+            }
+        }
+        catch (error) {
+            this.isSpeaking = false;
+            if (error instanceof TTSError) {
+                this.emit('error', error);
+                throw error;
+            }
+            const ttsError = new TTSError('Speak failed', TTSErrorCode.UNKNOWN, 'speaker', error);
+            this.emit('error', ttsError);
+            throw ttsError;
+        }
+    }
+    /**
+     * 暂停播放
+     */
+    pause() {
+        if (this.player && this.isSpeaking && !this.isPaused) {
+            this.player.pause();
+        }
+    }
+    /**
+     * 恢复播放
+     */
+    resume() {
+        if (this.player && this.isPaused) {
+            this.player.resume();
+        }
+    }
+    /**
+     * 停止播放
+     */
+    async stop() {
+        this.isSpeaking = false;
+        this.isPaused = false;
+        if (this.player) {
+            await this.player.stop();
+        }
+    }
+    /**
+     * 销毁 Speaker，释放资源
+     */
+    async destroy() {
+        this.isSpeaking = false;
+        this.isPaused = false;
+        if (this.player) {
+            await this.player.stop();
+            this.player = undefined;
+        }
+        this.currentProvider = undefined;
+        this.currentText = undefined;
+    }
+    /**
+     * 列出可用音色
+     */
+    async listVoices(providerName) {
+        const name = providerName || this.options.defaultProvider || 'minimax';
+        const provider = getProvider(name);
+        return provider.listVoices();
+    }
+    /**
+     * 获取 Provider 能力
+     */
+    getCapabilities(providerName) {
+        const name = providerName || this.options.defaultProvider || 'minimax';
+        const provider = getProvider(name);
+        return provider.getCapabilities();
+    }
+    /**
+     * 获取所有已注册的 Provider
+     */
+    getProviders() {
+        return listProviders();
+    }
+    /**
+     * 是否正在播放
+     */
+    isPlaying() {
+        return this.isSpeaking && !this.isPaused;
+    }
+    /**
+     * 是否暂停
+     */
+    isPausedState() {
+        return this.isPaused;
+    }
+}
+// ============================================================================
+// 便捷函数 - 默认 Speaker 实例
+// ============================================================================
+let defaultSpeaker;
+/**
+ * 获取默认 Speaker 实例（单例）
+ */
+export function getDefaultSpeaker() {
+    if (!defaultSpeaker) {
+        defaultSpeaker = new Speaker();
+    }
+    return defaultSpeaker;
+}
+/**
+ * 说话（便捷函数）
+ */
+export async function speak(text, options) {
+    const speaker = getDefaultSpeaker();
+    return speaker.speak(text, options);
+}
+/**
+ * 停止（便捷函数）
+ */
+export async function stop() {
+    const speaker = getDefaultSpeaker();
+    return speaker.stop();
+}
+/**
+ * 暂停（便捷函数）
+ */
+export function pause() {
+    const speaker = getDefaultSpeaker();
+    speaker.pause();
+}
+/**
+ * 恢复（便捷函数）
+ */
+export function resume() {
+    const speaker = getDefaultSpeaker();
+    speaker.resume();
+}
+/**
+ * 列出音色（便捷函数）
+ */
+export async function listVoices(providerName) {
+    const speaker = getDefaultSpeaker();
+    return speaker.listVoices(providerName);
+}
+export default Speaker;
+//# sourceMappingURL=speaker.js.map

package/dist/core/speaker.js.map

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

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

@@ -0,0 +1,107 @@
+/**
+ * StreamPlayer - 真正的边收边播流式音频播放器
+ * 接收音频 chunk，同时写入临时文件并立即启动播放器播放
+ */
+import { EventEmitter } from 'events';
+/**
+ * StreamPlayer Events - 流式播放器事件回调接口
+ */
+export interface StreamPlayerEvents {
+    onProgress?: (bytesWritten: number) => void;
+    onStart?: () => void;
+    onEnd?: () => void;
+    onError?: (error: Error) => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    onStop?: () => void;
+}
+/**
+ * StreamPlayer Options - 流式播放器配置选项
+ */
+export interface StreamPlayerOptions {
+    format?: 'mp3' | 'wav' | 'flac';
+    events?: StreamPlayerEvents;
+}
+/**
+ * StreamPlayer - 边收边播的流式音频播放器
+ *
+ * 特性：
+ * - 写入临时文件的同时立即启动播放器
+ * - 支持 pause/resume/stop 控制
+ * - 跨平台支持：macOS (afplay), Linux (aplay), Windows (PowerShell)
+ */
+export declare class StreamPlayer extends EventEmitter {
+    private tempFile;
+    private writeStream?;
+    private playerProcess?;
+    private _bytesWritten;
+    private _started;
+    private _paused;
+    private _stopped;
+    private format;
+    private events?;
+    constructor(options?: StreamPlayerOptions);
+    /**
+     * 开始播放
+     * 创建临时文件，创建写入流，启动播放器进程
+     */
+    start(): void;
+    /**
+     * 启动播放器进程
+     */
+    private startPlayer;
+    /**
+     * 写入音频数据块（边收边写）
+     * 如果尚未 start()，会自动调用
+     */
+    write(chunk: Buffer): void;
+    /**
+     * 结束写入
+     * 关闭写入流，但不杀播放器进程，让它播完
+     */
+    end(): void;
+    /**
+     * 停止播放
+     * 杀死播放器进程，删除临时文件
+     */
+    stop(): void;
+    /**
+     * 暂停播放
+     * 使用 SIGSTOP 暂停播放器进程
+     */
+    pause(): void;
+    /**
+     * 恢复播放
+     */
+    resume(): void;
+    /**
+     * 是否已启动
+     */
+    isStarted(): boolean;
+    /**
+     * 是否暂停
+     */
+    isPaused(): boolean;
+    /**
+     * 是否已停止
+     */
+    isStopped(): boolean;
+    /**
+     * 获取已写入的字节数
+     */
+    getBytesWritten(): number;
+    /**
+     * 获取临时文件路径
+     */
+    getTempFile(): string;
+    /**
+     * 处理错误
+     */
+    private handleError;
+    /**
+     * 删除临时文件
+     */
+    private deleteTempFile;
+}
+export default StreamPlayer;
+//# sourceMappingURL=stream-player.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream-player.d.ts","sourceRoot":"","sources":["../../src/core/stream-player.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAOrC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,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,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,mBAAmB;IAClC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC/B,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,aAAa,CAAC,CAAc;IACpC,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAC,CAAoB;gBAEvB,OAAO,GAAE,mBAAwB;IAM7C;;;OAGG;IACH,KAAK,IAAI,IAAI;IA6Bb;;OAEG;IACH,OAAO,CAAC,WAAW;IAkDnB;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA6B1B;;;OAGG;IACH,GAAG,IAAI,IAAI;IAOX;;;OAGG;IACH,IAAI,IAAI,IAAI;IAgCZ;;;OAGG;IACH,KAAK,IAAI,IAAI;IAiBb;;OAEG;IACH,MAAM,IAAI,IAAI;IAiBd;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,cAAc;CAYvB;AAED,eAAe,YAAY,CAAA"}

package/dist/core/stream-player.js

@@ -0,0 +1,272 @@
+/**
+ * StreamPlayer - 真正的边收边播流式音频播放器
+ * 接收音频 chunk，同时写入临时文件并立即启动播放器播放
+ */
+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';
+/**
+ * StreamPlayer - 边收边播的流式音频播放器
+ *
+ * 特性：
+ * - 写入临时文件的同时立即启动播放器
+ * - 支持 pause/resume/stop 控制
+ * - 跨平台支持：macOS (afplay), Linux (aplay), Windows (PowerShell)
+ */
+export class StreamPlayer extends EventEmitter {
+    tempFile = '';
+    writeStream;
+    playerProcess;
+    _bytesWritten = 0;
+    _started = false;
+    _paused = false;
+    _stopped = false;
+    format = 'mp3';
+    events;
+    constructor(options = {}) {
+        super();
+        this.format = options.format || 'mp3';
+        this.events = options.events;
+    }
+    /**
+     * 开始播放
+     * 创建临时文件，创建写入流，启动播放器进程
+     */
+    start() {
+        if (this._started) {
+            return;
+        }
+        // 创建临时文件
+        this.tempFile = join(tmpdir(), `ocosay-stream-${Date.now()}.${this.format}`);
+        // 创建写入流
+        this.writeStream = createWriteStream(this.tempFile, { highWaterMark: 64 * 1024 });
+        this.writeStream.on('error', (error) => {
+            this.handleError(error);
+        });
+        this.writeStream.on('finish', () => {
+            // 写入完成，但播放器可能还在播放
+        });
+        // 启动播放器进程
+        this.startPlayer();
+        this._started = true;
+        this._stopped = false;
+        this.events?.onStart?.();
+        this.emit('start');
+    }
+    /**
+     * 启动播放器进程
+     */
+    startPlayer() {
+        const platform = process.platform;
+        let command;
+        let args;
+        if (platform === 'darwin') {
+            // macOS
+            command = 'afplay';
+            args = [this.tempFile];
+        }
+        else if (platform === 'linux') {
+            // Linux
+            command = 'aplay';
+            args = [this.tempFile];
+        }
+        else {
+            // Windows - PlaySync is synchronous and blocks the event loop
+            // Return error to indicate Windows is not supported for streaming
+            this.handleError(new Error('Windows platform is not supported for stream playback. PlaySync() blocks the Node.js event loop.'));
+            return;
+        }
+        this.playerProcess = spawn(command, args, {
+            stdio: 'ignore',
+            detached: false
+        });
+        this.playerProcess.on('exit', (code, signal) => {
+            // 如果是正常结束或被信号终止，不当作错误
+            if (this._stopped) {
+                return;
+            }
+            if (signal === 'SIGTERM' || signal === 'SIGINT') {
+                // 被主动停止
+                return;
+            }
+            if (code === 0 || code === null) {
+                // 正常播放结束
+                this.events?.onEnd?.();
+                this.emit('end');
+            }
+            else {
+                this.handleError(new Error(`Player exited with code ${code}`));
+            }
+        });
+        this.playerProcess.on('error', (error) => {
+            this.handleError(error);
+        });
+    }
+    /**
+     * 写入音频数据块（边收边写）
+     * 如果尚未 start()，会自动调用
+     */
+    write(chunk) {
+        // 如果已停止，直接忽略
+        if (this._stopped) {
+            return;
+        }
+        // 如果未启动，自动启动
+        if (!this._started) {
+            this.start();
+        }
+        // 写入数据到文件
+        if (this.writeStream) {
+            const canContinue = this.writeStream.write(chunk);
+            if (!canContinue) {
+                // 写入缓冲区满了，等待 drain 事件
+                this.writeStream.once('drain', () => {
+                    // 可以继续写入
+                });
+            }
+            this._bytesWritten += chunk.length;
+            this.events?.onProgress?.(this._bytesWritten);
+            this.emit('progress', this._bytesWritten);
+        }
+    }
+    /**
+     * 结束写入
+     * 关闭写入流，但不杀播放器进程，让它播完
+     */
+    end() {
+        if (this.writeStream) {
+            this.writeStream.end();
+            this.writeStream = undefined;
+        }
+    }
+    /**
+     * 停止播放
+     * 杀死播放器进程，删除临时文件
+     */
+    stop() {
+        this._stopped = true;
+        this._started = false;
+        this._paused = false;
+        // 杀死播放器进程
+        if (this.playerProcess) {
+            try {
+                this.playerProcess.kill('SIGTERM');
+            }
+            catch (e) {
+                // 忽略错误
+            }
+            this.playerProcess = undefined;
+        }
+        // 关闭写入流
+        if (this.writeStream) {
+            try {
+                this.writeStream.destroy();
+            }
+            catch (e) {
+                // 忽略错误
+            }
+            this.writeStream = undefined;
+        }
+        // 删除临时文件
+        this.deleteTempFile();
+        this.events?.onStop?.();
+        this.emit('stop');
+    }
+    /**
+     * 暂停播放
+     * 使用 SIGSTOP 暂停播放器进程
+     */
+    pause() {
+        if (!this._started || this._paused || this._stopped) {
+            return;
+        }
+        if (this.playerProcess) {
+            try {
+                this.playerProcess.kill('SIGSTOP');
+                this._paused = true;
+                this.events?.onPause?.();
+                this.emit('pause');
+            }
+            catch (e) {
+                // 如果 kill 失败，忽略
+            }
+        }
+    }
+    /**
+     * 恢复播放
+     */
+    resume() {
+        if (!this._paused || this._stopped) {
+            return;
+        }
+        if (this.playerProcess) {
+            try {
+                this.playerProcess.kill('SIGCONT');
+                this._paused = false;
+                this.events?.onResume?.();
+                this.emit('resume');
+            }
+            catch (e) {
+                // 如果 kill 失败，忽略
+            }
+        }
+    }
+    /**
+     * 是否已启动
+     */
+    isStarted() {
+        return this._started;
+    }
+    /**
+     * 是否暂停
+     */
+    isPaused() {
+        return this._paused;
+    }
+    /**
+     * 是否已停止
+     */
+    isStopped() {
+        return this._stopped;
+    }
+    /**
+     * 获取已写入的字节数
+     */
+    getBytesWritten() {
+        return this._bytesWritten;
+    }
+    /**
+     * 获取临时文件路径
+     */
+    getTempFile() {
+        return this.tempFile;
+    }
+    /**
+     * 处理错误
+     */
+    handleError(error) {
+        this.events?.onError?.(error);
+        this.emit('error', error);
+    }
+    /**
+     * 删除临时文件
+     */
+    deleteTempFile() {
+        if (this.tempFile) {
+            try {
+                if (fs.existsSync(this.tempFile)) {
+                    fs.unlinkSync(this.tempFile);
+                }
+            }
+            catch (e) {
+                // 忽略删除错误
+            }
+            this.tempFile = '';
+        }
+    }
+}
+export default StreamPlayer;
+//# sourceMappingURL=stream-player.js.map

package/dist/core/stream-player.js.map

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