@mingxy/ocosay 1.0.0

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

@@ -0,0 +1,34 @@
+/**
+ * PowerShell Backend - Windows 平台音频播放后端
+ * 使用 PowerShell 的 [System.Media.SoundPlayer] 异步 API
+ */
+import { AudioBackend, BackendOptions } from './base';
+/**
+ * PowerShellBackend - Windows 原生音频播放后端
+ * 使用 PowerShell 异步方式避免阻塞事件循环
+ * 不支持真正的流式播放
+ */
+export declare class PowerShellBackend implements AudioBackend {
+    readonly name = "powershell";
+    readonly supportsStreaming = false;
+    private process?;
+    private tempFile?;
+    private events?;
+    private _started;
+    private _paused;
+    private _stopped;
+    private chunks;
+    private hasEnded;
+    constructor(options?: BackendOptions);
+    start(filePath: string): void;
+    write(chunk: Buffer): void;
+    end(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    setVolume(_volume: number): void;
+    destroy(): void;
+    private cleanup;
+    private handleError;
+}
+//# sourceMappingURL=powershell-backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"powershell-backend.d.ts","sourceRoot":"","sources":["../../../src/core/backends/powershell-backend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAsB,cAAc,EAAE,MAAM,QAAQ,CAAA;AAgBzE;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,IAAI,gBAAe;IAC5B,QAAQ,CAAC,iBAAiB,SAAQ;IAElC,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;IAExB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,OAAO,GAAE,cAAmB;IAIxC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmD7B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B,GAAG,IAAI,IAAI;IAaX,KAAK,IAAI,IAAI;IAMb,MAAM,IAAI,IAAI;IAMd,IAAI,IAAI,IAAI;IAqBZ,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,WAAW;CAGpB"}

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

@@ -0,0 +1,154 @@
+/**
+ * PowerShell Backend - Windows 平台音频播放后端
+ * 使用 PowerShell 的 [System.Media.SoundPlayer] 异步 API
+ */
+import { spawn } from 'child_process';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { writeFileSync, unlinkSync, existsSync } from 'fs';
+// 白名单：Windows 路径格式（禁止 - 防止命令注入）
+const SAFE_PATH_REGEX = /^[\w\:\\_.]+$/i;
+// 定义不支持操作的错误类
+class UnsupportedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UnsupportedError';
+    }
+}
+/**
+ * PowerShellBackend - Windows 原生音频播放后端
+ * 使用 PowerShell 异步方式避免阻塞事件循环
+ * 不支持真正的流式播放
+ */
+export class PowerShellBackend {
+    name = 'powershell';
+    supportsStreaming = false;
+    process;
+    tempFile;
+    events;
+    _started = false;
+    _paused = false;
+    _stopped = false;
+    // P0-4: 缓冲所有chunk，等end()时一次性写入文件
+    chunks = [];
+    hasEnded = false;
+    constructor(options = {}) {
+        this.events = options.events;
+    }
+    start(filePath) {
+        if (this._started)
+            return;
+        if (!SAFE_PATH_REGEX.test(filePath)) {
+            throw new Error(`Invalid file path: ${filePath}`);
+        }
+        this.tempFile = filePath;
+        this._started = true;
+        this._stopped = false;
+        this.events?.onStart?.();
+        // 安全方案：将路径写入临时脚本文件，避免命令行注入
+        const escapedPath = filePath.replace(/'/g, "''");
+        const psScript = `$sound = New-Object System.Media.SoundPlayer('${escapedPath}'); $sound.PlayAsync()`;
+        const scriptFile = join(tmpdir(), `ocosay-${Date.now()}.ps1`);
+        writeFileSync(scriptFile, psScript, { encoding: 'utf8' });
+        this.process = spawn('powershell', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptFile], {
+            stdio: 'ignore',
+            detached: false
+        });
+        // 清理脚本文件
+        this.process.on('exit', () => {
+            try {
+                if (existsSync(scriptFile)) {
+                    unlinkSync(scriptFile);
+                }
+            }
+            catch (e) {
+                // 忽略清理错误
+            }
+        });
+        this.process.on('exit', (code) => {
+            if (this._stopped)
+                return;
+            if (code === 0 || code === null) {
+                this._started = false;
+                this.events?.onEnd?.();
+            }
+            else {
+                this.handleError(new Error(`PowerShell playback exited with code ${code}`));
+            }
+        });
+        this.process.on('error', (error) => {
+            this.handleError(error);
+        });
+    }
+    write(chunk) {
+        if (this._stopped)
+            return;
+        // P0-4: 缓冲所有chunk，等end()时一次性写入
+        this.chunks.push(chunk);
+    }
+    end() {
+        if (this._stopped || this.hasEnded)
+            return;
+        this.hasEnded = true;
+        if (this.chunks.length === 0)
+            return;
+        // P0-4: 所有chunk缓冲完毕后，一次性写入文件并播放
+        this.tempFile = join(tmpdir(), `ocosay-${Date.now()}.wav`);
+        writeFileSync(this.tempFile, Buffer.concat(this.chunks));
+        this.chunks = [];
+        this.start(this.tempFile);
+    }
+    pause() {
+        if (!this._started || this._paused || this._stopped)
+            return;
+        // PowerShell SoundPlayer.PlayAsync() 不支持暂停，抛错明确告知
+        throw new UnsupportedError('pause is not supported by PowerShell SoundPlayer');
+    }
+    resume() {
+        if (!this._paused || this._stopped)
+            return;
+        // PowerShell SoundPlayer.PlayAsync() 不支持恢复，抛错明确告知
+        throw new UnsupportedError('resume is not supported by PowerShell SoundPlayer');
+    }
+    stop() {
+        this._stopped = true;
+        this._started = false;
+        this._paused = false;
+        if (this.process) {
+            try {
+                this.process.kill('SIGTERM');
+            }
+            catch (e) {
+                // 忽略错误
+            }
+            this.process = undefined;
+        }
+        this.cleanup();
+        this.chunks = [];
+        this.hasEnded = false;
+        this.events?.onStop?.();
+    }
+    setVolume(_volume) {
+        // PowerShell SoundPlayer 不支持音量控制
+    }
+    destroy() {
+        this.stop();
+    }
+    cleanup() {
+        if (this.tempFile && this.tempFile.startsWith(tmpdir())) {
+            try {
+                if (existsSync(this.tempFile)) {
+                    unlinkSync(this.tempFile);
+                }
+            }
+            catch (e) {
+                // 忽略清理错误
+            }
+            this.tempFile = undefined;
+        }
+    }
+    handleError(error) {
+        this.events?.onError?.(error);
+    }
+}
+//# sourceMappingURL=powershell-backend.js.map

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

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

package/dist/core/player.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Audio Player Module
+ * 音频播放引擎 - 支持 pause/resume/stop 和流式播放
+ */
+import { EventEmitter } from 'events';
+/**
+ * Player Events - 播放事件回调接口
+ */
+export interface PlayerEvents {
+    onStart?: () => void;
+    onEnd?: () => void;
+    onError?: (error: Error) => void;
+    onProgress?: (progress: {
+        current: number;
+        total: number;
+    }) => void;
+    onPause?: () => void;
+    onResume?: () => void;
+    onStop?: () => void;
+}
+/**
+ * Player 接口 - 音频播放器标准接口
+ */
+export interface Player {
+    play(audioData: Buffer | ReadableStream, format: string): Promise<void>;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    isPlaying(): boolean;
+    isPaused(): boolean;
+}
+/**
+ * AudioPlayer - 基于系统播放器的音频播放实现
+ * 支持 macOS (afplay), Linux (aplay), Windows (PowerShell)
+ */
+export declare class AudioPlayer extends EventEmitter implements Player {
+    protected events?: PlayerEvents | undefined;
+    private _playing;
+    private _paused;
+    private currentProcess?;
+    private currentFile?;
+    constructor(events?: PlayerEvents | undefined);
+    /**
+     * 播放音频
+     * @param audioData 音频数据 (Buffer 或 ReadableStream)
+     * @param format 音频格式 (mp3, wav, etc.)
+     */
+    play(audioData: Buffer | ReadableStream, format: string): Promise<void>;
+    /**
+     * 播放音频文件
+     * 优先使用 afplay (macOS), aplay (Linux), 否则用 PowerShell (Windows)
+     */
+    private playFile;
+    /**
+     * 暂停播放
+     * 注意: 目前通过 SIGSTOP 实现，真正的 pause 需要支持暂停的音频库
+     */
+    pause(): void;
+    /**
+     * 恢复播放
+     */
+    resume(): void;
+    /**
+     * 停止播放
+     */
+    stop(): Promise<void>;
+    /**
+     * 是否正在播放
+     */
+    isPlaying(): boolean;
+    /**
+     * 是否暂停
+     */
+    isPaused(): boolean;
+    /**
+     * 清理临时文件
+     */
+    private cleanup;
+}
+/**
+ * StreamingPlayer - 流式播放器，支持边下载边播放
+ * 注意: 当前实现是下载完毕后再播放，onProgress 事件用于报告下载进度
+ */
+export declare class StreamingPlayer extends AudioPlayer {
+    private chunks;
+    private downloadedSize;
+    constructor(events?: PlayerEvents);
+    /**
+     * 流式下载并播放
+     * @param stream 可读流
+     * @param format 音频格式
+     * @param expectedSize 预期大小（可选），用于进度报告
+     */
+    streamAndPlay(stream: ReadableStream, format: string, expectedSize?: number): Promise<void>;
+}
+export default AudioPlayer;
+//# sourceMappingURL=player.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/player.js

@@ -0,0 +1,268 @@
+/**
+ * Audio Player Module
+ * 音频播放引擎 - 支持 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';
+/**
+ * AudioPlayer - 基于系统播放器的音频播放实现
+ * 支持 macOS (afplay), Linux (aplay), Windows (PowerShell)
+ */
+export class AudioPlayer extends EventEmitter {
+    events;
+    _playing = false;
+    _paused = false;
+    currentProcess;
+    currentFile;
+    constructor(events) {
+        super();
+        this.events = events;
+    }
+    /**
+     * 播放音频
+     * @param audioData 音频数据 (Buffer 或 ReadableStream)
+     * @param format 音频格式 (mp3, wav, etc.)
+     */
+    async play(audioData, format) {
+        // 如果正在播放，先停止
+        if (this._playing) {
+            await this.stop();
+        }
+        this._playing = true;
+        this._paused = false;
+        try {
+            // 将音频数据写入临时文件
+            const tempFile = join(tmpdir(), `ocosay-${Date.now()}.${format}`);
+            this.currentFile = tempFile;
+            if (Buffer.isBuffer(audioData)) {
+                fs.writeFileSync(tempFile, audioData);
+            }
+            else {
+                const writeStream = createWriteStream(tempFile);
+                const reader = audioData.getReader();
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        if (value instanceof Uint8Array) {
+                            writeStream.write(Buffer.from(value));
+                        }
+                    }
+                    writeStream.end();
+                }
+                finally {
+                    reader.releaseLock();
+                }
+                await new Promise((resolve, reject) => {
+                    writeStream.on('finish', resolve);
+                    writeStream.on('error', reject);
+                });
+            }
+            // 触发开始事件
+            this.events?.onStart?.();
+            this.emit('start');
+            // 根据格式选择播放器
+            await this.playFile(tempFile, format);
+            // 播放完成
+            this._playing = false;
+            this.events?.onEnd?.();
+            this.emit('end');
+            // 清理临时文件
+            this.cleanup();
+        }
+        catch (error) {
+            this._playing = false;
+            const ttsError = new TTSError(error.message || 'Playback failed', TTSErrorCode.PLAYER_ERROR, 'player');
+            this.events?.onError?.(ttsError);
+            this.emit('error', ttsError);
+            throw ttsError;
+        }
+    }
+    /**
+     * 播放音频文件
+     * 优先使用 afplay (macOS), aplay (Linux), 否则用 PowerShell (Windows)
+     */
+    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);
+            });
+        });
+    }
+    /**
+     * 暂停播放
+     * 注意: 目前通过 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 失败，忽略
+            }
+        }
+    }
+    /**
+     * 恢复播放
+     */
+    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 失败，忽略
+            }
+        }
+    }
+    /**
+     * 停止播放
+     */
+    async stop() {
+        this._playing = false;
+        this._paused = false;
+        if (this.currentProcess) {
+            try {
+                this.currentProcess.kill('SIGTERM');
+            }
+            catch (e) {
+                // 忽略错误
+            }
+            this.currentProcess = undefined;
+        }
+        this.cleanup();
+        this.events?.onStop?.();
+        this.emit('stop');
+    }
+    /**
+     * 是否正在播放
+     */
+    isPlaying() {
+        return this._playing;
+    }
+    /**
+     * 是否暂停
+     */
+    isPaused() {
+        return this._paused;
+    }
+    /**
+     * 清理临时文件
+     */
+    cleanup() {
+        if (this.currentFile) {
+            try {
+                if (fs.existsSync(this.currentFile)) {
+                    fs.unlinkSync(this.currentFile);
+                }
+            }
+            catch (e) {
+                // 忽略清理错误
+            }
+            this.currentFile = undefined;
+        }
+    }
+}
+/**
+ * StreamingPlayer - 流式播放器，支持边下载边播放
+ * 注意: 当前实现是下载完毕后再播放，onProgress 事件用于报告下载进度
+ */
+export class StreamingPlayer extends AudioPlayer {
+    chunks = [];
+    downloadedSize = 0;
+    constructor(events) {
+        super(events);
+    }
+    /**
+     * 流式下载并播放
+     * @param stream 可读流
+     * @param format 音频格式
+     * @param expectedSize 预期大小（可选），用于进度报告
+     */
+    async streamAndPlay(stream, format, expectedSize) {
+        const reader = stream.getReader();
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                if (value instanceof Buffer) {
+                    this.chunks.push(value);
+                    this.downloadedSize += value.length;
+                    // 触发下载进度
+                    if (expectedSize) {
+                        this.emit('progress', {
+                            current: this.downloadedSize,
+                            total: expectedSize
+                        });
+                        this.events?.onProgress?.({
+                            current: this.downloadedSize,
+                            total: expectedSize
+                        });
+                    }
+                }
+            }
+            // 合并所有 chunk 并播放
+            const fullAudio = Buffer.concat(this.chunks);
+            await this.play(fullAudio, format);
+        }
+        finally {
+            reader.releaseLock();
+            this.chunks = [];
+            this.downloadedSize = 0;
+        }
+    }
+}
+export default AudioPlayer;
+//# sourceMappingURL=player.js.map

package/dist/core/player.js.map

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

package/dist/core/speaker.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Speaker - TTS 统一调用入口
+ * 提供简洁的 API 和便捷函数
+ */
+import { EventEmitter } from 'events';
+import { SpeakOptions, Voice, TTSEvent, SynthesisModel } from './types';
+export interface SpeakerOptions {
+    defaultProvider?: string;
+    defaultModel?: SynthesisModel;
+    defaultVoice?: string;
+    onEvent?: (event: TTSEvent, data?: any) => void;
+}
+/**
+ * Speaker - TTS 统一调用入口类
+ * 封装 Provider 和 Player，提供简洁的 speak/pause/resume/stop API
+ */
+export declare class Speaker extends EventEmitter {
+    private options;
+    private currentProvider?;
+    private player?;
+    private currentText?;
+    private isSpeaking;
+    private isPaused;
+    constructor(options?: SpeakerOptions);
+    /**
+     * 说话 - 核心方法
+     * @param text 要说的文本
+     * @param options 可选参数
+     */
+    speak(text: string, options?: SpeakOptions & {
+        provider?: string;
+    }): Promise<void>;
+    /**
+     * 暂停播放
+     */
+    pause(): void;
+    /**
+     * 恢复播放
+     */
+    resume(): void;
+    /**
+     * 停止播放
+     */
+    stop(): Promise<void>;
+    /**
+     * 销毁 Speaker，释放资源
+     */
+    destroy(): Promise<void>;
+    /**
+     * 列出可用音色
+     */
+    listVoices(providerName?: string): Promise<Voice[]>;
+    /**
+     * 获取 Provider 能力
+     */
+    getCapabilities(providerName?: string): import("./types").TTSCapabilities;
+    /**
+     * 获取所有已注册的 Provider
+     */
+    getProviders(): string[];
+    /**
+     * 是否正在播放
+     */
+    isPlaying(): boolean;
+    /**
+     * 是否暂停
+     */
+    isPausedState(): boolean;
+}
+/**
+ * 获取默认 Speaker 实例（单例）
+ */
+export declare function getDefaultSpeaker(): Speaker;
+/**
+ * 说话（便捷函数）
+ */
+export declare function speak(text: string, options?: SpeakOptions & {
+    provider?: string;
+}): Promise<void>;
+/**
+ * 停止（便捷函数）
+ */
+export declare function stop(): Promise<void>;
+/**
+ * 暂停（便捷函数）
+ */
+export declare function pause(): void;
+/**
+ * 恢复（便捷函数）
+ */
+export declare function resume(): void;
+/**
+ * 列出音色（便捷函数）
+ */
+export declare function listVoices(providerName?: string): Promise<Voice[]>;
+export default Speaker;
+//# sourceMappingURL=speaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"speaker.d.ts","sourceRoot":"","sources":["../../src/core/speaker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAIL,YAAY,EAEZ,KAAK,EACL,QAAQ,EACR,cAAc,EACf,MAAM,SAAS,CAAA;AAIhB,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;CAChD;AAED;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IAO3B,OAAO,CAAC,OAAO;IAN3B,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAQ;gBAEJ,OAAO,GAAE,cAAmB;IA6BhD;;;;OAIG;IACG,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GACjD,OAAO,CAAC,IAAI,CAAC;IA+DhB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B;;OAEG;IACG,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAMzD;;OAEG;IACH,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM;IAMrC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAQD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED;;GAEG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAG1C;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAG5B;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAG7B;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAGxE;AAED,eAAe,OAAO,CAAA"}