@coeiro-operator/audio 1.0.0

package/README.md

@@ -0,0 +1,11 @@
+# @coeiro-operator/audio
+
+COEIRO Operator音声合成・再生モジュール
+
+内部パッケージです。直接のインストールは推奨されません。
+
+COEIROINK APIとの通信、音声ストリーミング、リサンプリング機能を提供します。
+
+## ライセンス
+
+MIT

package/dist/audio-player.d.ts

@@ -0,0 +1,134 @@
+/**
+ * src/say/audio-player.ts: 音声再生管理
+ * speakerライブラリによるネイティブ音声出力を担当
+ */
+import type { AudioResult, Config } from './types.js';
+export declare const forTests: {
+    mockSpeakerInstance: any;
+};
+export declare class AudioPlayer {
+    private synthesisRate;
+    private playbackRate;
+    private channels;
+    private bitDepth;
+    private echogardenInitialized;
+    private noiseReductionEnabled;
+    private lowpassFilterEnabled;
+    private lowpassCutoff;
+    private isInitialized;
+    private audioConfig;
+    private config;
+    /**
+     * AudioPlayerの初期化
+     */
+    constructor(config: Config);
+    /**
+     * デフォルトのaudio設定を取得
+     */
+    private getDefaultAudioConfig;
+    /**
+     * 動的バッファサイズの計算
+     */
+    private calculateOptimalBufferSize;
+    /**
+     * 音声生成時のサンプルレートを設定
+     */
+    setSynthesisRate(synthesisRate: number): void;
+    /**
+     * 再生時のサンプルレートを設定
+     */
+    setPlaybackRate(playbackRate: number): void;
+    /**
+     * ノイズ除去機能を有効/無効に設定
+     */
+    setNoiseReduction(enabled: boolean): void;
+    /**
+     * ローパスフィルターを有効/無効に設定
+     */
+    setLowpassFilter(enabled: boolean, cutoffFreq?: number): void;
+    /**
+     * Echogardenの初期化
+     */
+    private initializeEchogarden;
+    initialize(): Promise<boolean>;
+    /**
+     * 音声ストリームを再生（ストリーミング処理パイプライン）
+     */
+    playAudioStream(audioResult: AudioResult, bufferSize?: number): Promise<void>;
+    /**
+     * ストリーミング音声処理パイプライン
+     * 処理順序: 1) リサンプリング 2) ローパスフィルター 3) ノイズリダクション 4) Speaker出力
+     */
+    private processAudioStreamPipeline;
+    /**
+     * リサンプリング用Transform streamを作成
+     */
+    private createResampleTransform;
+    /**
+     * ローパスフィルター用Transform streamを作成
+     */
+    private createLowpassTransform;
+    /**
+     * ノイズリダクション用Transform streamを作成
+     */
+    private createNoiseReductionTransform;
+    /**
+     * 真のストリーミング音声再生（非同期ジェネレータから直接再生）
+     */
+    playStreamingAudio(audioStream: AsyncGenerator<AudioResult>, bufferSize?: number): Promise<void>;
+    /**
+     * 並列ストリーミング再生（最初のチャンクから再生開始、以降は自動継続）
+     */
+    playStreamingAudioParallel(audioStream: AsyncGenerator<AudioResult>): Promise<void>;
+    /**
+     * Speakerインスタンスを作成（環境変数によるモック対応）
+     */
+    private createSpeaker;
+    /**
+     * PCMデータを直接スピーカーに再生（改善版：Speakerインスタンス使い回し）
+     * synthesis/playbackレートが異なる場合は適切なSpeaker設定を使用
+     */
+    private playPCMData;
+    /**
+     * 音声ファイルを保存
+     */
+    saveAudio(audioBuffer: ArrayBuffer, outputFile: string): Promise<void>;
+    /**
+     * チャンク単位のローパスフィルター処理
+     */
+    private applyLowpassFilterToChunk;
+    /**
+     * チャンク単位のノイズリダクション処理
+     */
+    private applyNoiseReductionToChunk;
+    /**
+     * WAVヘッダーを除去してPCMデータを抽出
+     */
+    extractPCMFromWAV(wavBuffer: ArrayBuffer): Uint8Array;
+    /**
+     * クロスフェード処理を適用（改良版）
+     */
+    applyCrossfade(pcmData: Uint8Array, overlapSamples: number, isFirstChunk?: boolean): Uint8Array;
+    /**
+     * より自然なフェード曲線（smoothstep関数）
+     */
+    private smoothstep;
+    /**
+     * 無音PCMデータを生成
+     * @param durationMs 無音の長さ（ミリ秒）
+     * @param sampleRate サンプルレート（デフォルト：24000Hz）
+     * @returns 無音のPCMデータ
+     */
+    generateSilentPCM(durationMs?: number, sampleRate?: number): Uint8Array;
+    /**
+     * ドライバーウォームアップ用の無音再生
+     * 短い無音を再生してSpeakerドライバーを起動・安定化
+     */
+    warmupAudioDriver(): Promise<void>;
+    /**
+     * AudioPlayerのクリーンアップ（リソース解放）
+     * 長時間運用やシャットダウン時に呼び出し
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=audio-player.d.ts.map