@coeiro-operator/audio 1.0.1 → 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 COEIRO Operator
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

package/dist/audio-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-player.d.ts","sourceRoot":"","sources":["../src/audio-player.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,EAAe,MAAM,YAAY,CAAC;AAY1E,eAAO,MAAM,QAAQ;yBACU,GAAG;CACjC,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,qBAAqB,CAAkB;IAC/C,OAAO,CAAC,qBAAqB,CAAoD;IACjF,OAAO,CAAC,oBAAoB,CAAmD;IAC/E,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAS;IAEvB;;OAEG;gBACS,MAAM,EAAE,MAAM;IAK1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0C7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAgBlC;;OAEG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,GAAE,MAAuC,GAAG,IAAI;IAK7F;;OAEG;YACW,oBAAoB;IAW5B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBpC;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnF;;;OAGG;YACW,0BAA0B;IAiDxC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAoBrC;;OAEG;IACG,kBAAkB,CACtB,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC,EACxC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAehB;;OAEG;IACG,0BAA0B,CAAC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkCzF;;OAEG;YACW,aAAa;IAuI3B;;;OAGG;YACW,WAAW;IA2CzB;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5E;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqCjC;;OAEG;YACW,0BAA0B;IAqCxC;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,UAAU;IA2BrD;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,UAAU,EACnB,cAAc,EAAE,MAAM,EACtB,YAAY,GAAE,OAAe,GAC5B,UAAU;IA4Bb;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;;OAKG;IACH,iBAAiB,CACf,UAAU,GAAE,MAAY,EACxB,UAAU,GAAE,MAA+B,GAC1C,UAAU;IAMb;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB/B"}