@coeiro-operator/audio 1.0.2 → 1.1.0

package/README.md

@@ -6,6 +6,54 @@ COEIRO Operator音声合成・再生モジュール
 
 COEIROINK APIとの通信、音声ストリーミング、リサンプリング機能を提供します。
 
+## 機能
+
+- COEIROINK APIとの音声合成通信
+- 低レイテンシ音声ストリーミング
+- 音声再生（@echogarden/audio-io使用）
+- リアルタイムリサンプリング
+- チャンク境界での停止制御
+- クロスフェード処理
+- ノイズリダクション（オプション）
+
+## 音声出力モジュール
+
+音声出力には`@echogarden/audio-io`を使用しています。以下の特徴があります：
+
+- **プリコンパイル済みバイナリ**: node-gypによるビルドが不要
+- **CI/CD対応**: GitHub ActionsなどのCI環境でも動作
+- **低レイテンシ**: コールバックベースのAPIで効率的なバッファ管理
+- **マルチプラットフォーム**: macOS、Windows、Linuxをサポート
+
+## パフォーマンス
+
+@echogarden/audio-ioの採用により、以下のパフォーマンス改善を実現：
+
+- 初期化時間: 約0.03ms（高速）
+- チャンク処理: 平均1.47ms（低オーバーヘッド）
+- メモリ使用量: 約130MB RSS（効率的）
+
+## ドキュメント
+
+### ドキュメント構成
+
+```
+packages/audio/
+├── docs/
+│   ├── architecture.md                        # アーキテクチャ概要
+│   ├── task-orchestration.md                 # タスクキュー実装詳細
+│   ├── chunk-generation-manager-spec.md       # 並行生成仕様
+│   └── architecture-improvement-proposal.md   # 改善提案（未実施）
+└── README.md                                  # このファイル
+```
+
+### ドキュメント管理ルール
+
+- **アーキテクチャドキュメント**: `docs/` に機能ごとに配置
+- **複数ファイルにまたがる処理フロー**: 各ドキュメントに記述
+- **コードで明らかな情報**: ドキュメント化しない
+- **修正済みの内容**: ドキュメント内で ✅ マークで明示
+
 ## ライセンス
 
 MIT

package/dist/audio-player.d.ts

@@ -1,11 +1,8 @@
 /**
  * src/say/audio-player.ts: 音声再生管理
- * speakerライブラリによるネイティブ音声出力を担当
+ * @echogarden/audio-ioによる音声出力を担当
  */
 import type { AudioResult, Config } from './types.js';
-export declare const forTests: {
-    mockSpeakerInstance: any;
-};
 export declare class AudioPlayer {
     private synthesisRate;
     private playbackRate;
@@ -18,6 +15,11 @@ export declare class AudioPlayer {
     private isInitialized;
     private audioConfig;
     private config;
+    private shouldStop;
+    private audioOutput;
+    private chunkQueue;
+    private currentChunkOffset;
+    private completionPromise;
     /**
      * AudioPlayerの初期化
      */
@@ -57,7 +59,7 @@ export declare class AudioPlayer {
     playAudioStream(audioResult: AudioResult, bufferSize?: number): Promise<void>;
     /**
      * ストリーミング音声処理パイプライン
-     * 処理順序: 1) リサンプリング 2) ローパスフィルター 3) ノイズリダクション 4) Speaker出力
+     * 処理順序: 1) リサンプリング 2) ローパスフィルター 3) ノイズリダクション 4) 出力
      */
     private processAudioStreamPipeline;
     /**
@@ -77,16 +79,23 @@ export declare class AudioPlayer {
      */
     playStreamingAudio(audioStream: AsyncGenerator<AudioResult>, bufferSize?: number): Promise<void>;
     /**
-     * 並列ストリーミング再生（最初のチャンクから再生開始、以降は自動継続）
+     * キューが空になるまで待機（@echogarden/audio-io用）
      */
-    playStreamingAudioParallel(audioStream: AsyncGenerator<AudioResult>): Promise<void>;
+    private waitForCompletion;
     /**
-     * Speakerインスタンスを作成（環境変数によるモック対応）
+     * @echogarden/audio-io用のaudioOutputを遅延作成
      */
-    private createSpeaker;
+    private ensureAudioOutput;
     /**
-     * PCMデータを直接スピーカーに再生（改善版：Speakerインスタンス使い回し）
-     * synthesis/playbackレートが異なる場合は適切なSpeaker設定を使用
+     * @echogarden/audio-io用のコールバックハンドラ
+     */
+    private audioOutputHandler;
+    /**
+     * Uint8ArrayからInt16Arrayに変換（リトルエンディアン）
+     */
+    private convertToInt16Array;
+    /**
+     * PCMデータを音声出力キューに追加
      */
     private playPCMData;
     /**
@@ -125,6 +134,11 @@ export declare class AudioPlayer {
      * 短い無音を再生してSpeakerドライバーを起動・安定化
      */
     warmupAudioDriver(): Promise<void>;
+    /**
+     * 音声再生の停止（チャンク境界で停止）
+     * 現在再生中のチャンクは最後まで再生され、次のチャンクから停止します
+     */
+    stopPlayback(): Promise<void>;
     /**
      * AudioPlayerのクリーンアップ（リソース解放）
      * 長時間運用やシャットダウン時に呼び出し

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

@@ -1 +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"}
+{"version":3,"file":"audio-player.d.ts","sourceRoot":"","sources":["../src/audio-player.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,EAAe,MAAM,YAAY,CAAC;AAY1E,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;IAGvB,OAAO,CAAC,UAAU,CAAkB;IAGpC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,kBAAkB,CAAa;IACvC,OAAO,CAAC,iBAAiB,CAAkC;IAE3D;;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;IAmBpC;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCnF;;;OAGG;YACW,0BAA0B;IA6DxC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsD/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;IA8BhB;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;YACW,iBAAiB;IA+B/B;;OAEG;IACH,OAAO,CAAC,kBAAkB,CA8CxB;IAEF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;YACW,WAAW;IA+BzB;;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,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAwB/B"}

package/dist/audio-player.js

@@ -1,19 +1,16 @@
 /**
  * src/say/audio-player.ts: 音声再生管理
- * speakerライブラリによるネイティブ音声出力を担当
+ * @echogarden/audio-ioによる音声出力を担当
  */
 import { writeFile } from 'fs/promises';
 import * as Echogarden from 'echogarden';
-// @ts-ignore - dsp.jsには型定義がない
+// @ts-expect-error - dsp.jsには型定義がない
 import DSP from 'dsp.js';
 import { Transform } from 'stream';
-import { EventEmitter } from 'events';
+import { createAudioOutput } from '@echogarden/audio-io';
 import { logger } from '@coeiro-operator/common';
+import { OpenPromise } from './open-promise.js';
 import { SAMPLE_RATES, AUDIO_FORMAT, BUFFER_SIZES, FILTER_SETTINGS, CROSSFADE_SETTINGS, PADDING_SETTINGS, } from './constants.js';
-// テスト用のモックインスタンスを外部から注入可能にする
-export const forTests = {
-    mockSpeakerInstance: null,
-};
 export class AudioPlayer {
     synthesisRate = SAMPLE_RATES.SYNTHESIS;
     playbackRate = SAMPLE_RATES.PLAYBACK;
@@ -26,6 +23,13 @@ export class AudioPlayer {
     isInitialized = false;
     audioConfig;
     config;
+    // チャンク境界での停止制御フラグ
+    shouldStop = false;
+    // @echogarden/audio-io関連
+    audioOutput = null;
+    chunkQueue = [];
+    currentChunkOffset = 0;
+    completionPromise = null;
     /**
      * AudioPlayerの初期化
      */
@@ -137,7 +141,7 @@ export class AudioPlayer {
             if (this.noiseReductionEnabled) {
                 await this.initializeEchogarden();
             }
-            logger.info(`音声プレーヤー初期化: speakerライブラリ使用（ネイティブ出力）${this.noiseReductionEnabled ? ' + Echogarden' : ''} - Speaker遅延初期化`);
+            logger.info(`音声プレーヤー初期化: @echogarden/audio-io使用（プリコンパイル済みバイナリ）${this.noiseReductionEnabled ? ' + Echogarden' : ''}`);
             this.isInitialized = true;
             return true;
         }
@@ -170,7 +174,7 @@ export class AudioPlayer {
             }
             else {
                 // シンプルな直接再生
-                return this.playPCMData(pcmData, bufferSize);
+                return await this.playPCMData(pcmData, bufferSize);
             }
         }
         catch (error) {
@@ -179,45 +183,54 @@ export class AudioPlayer {
     }
     /**
      * ストリーミング音声処理パイプライン
-     * 処理順序: 1) リサンプリング 2) ローパスフィルター 3) ノイズリダクション 4) Speaker出力
+     * 処理順序: 1) リサンプリング 2) ローパスフィルター 3) ノイズリダクション 4) 出力
      */
     async processAudioStreamPipeline(pcmData) {
         logger.log('高品質音声処理パイプライン開始');
-        // Speakerインスタンスを新規作成
-        const streamSpeaker = await this.createSpeaker(this.playbackRate, BUFFER_SIZES.DEFAULT);
-        return new Promise((resolve, reject) => {
-            streamSpeaker.on('close', () => {
-                resolve();
-            });
-            streamSpeaker.on('error', (error) => {
-                logger.error(`ストリームスピーカーエラー: ${error.message}`);
-                reject(new Error(`音声再生エラー: ${error.message}`));
-            });
-            try {
-                // 1. リサンプリング（Transform stream）
-                const resampleTransform = this.createResampleTransform();
-                // 2. ローパスフィルター（Transform stream）
-                const lowpassTransform = this.createLowpassTransform();
-                // 3. ノイズリダクション（Transform stream）
-                const noiseReductionTransform = this.createNoiseReductionTransform();
-                // パイプライン構築: リサンプリング → ローパス → ノイズ除去 → Speaker
-                let pipeline = resampleTransform;
-                if (this.lowpassFilterEnabled) {
-                    pipeline = pipeline.pipe(lowpassTransform);
-                }
-                if (this.noiseReductionEnabled) {
-                    pipeline = pipeline.pipe(noiseReductionTransform);
-                }
-                pipeline.pipe(streamSpeaker);
+        // Transform streamを通して処理し、最終的にキューに追加
+        const processedChunks = [];
+        try {
+            // 1. リサンプリング（Transform stream）
+            const resampleTransform = this.createResampleTransform();
+            // 2. ローパスフィルター（Transform stream）
+            const lowpassTransform = this.createLowpassTransform();
+            // 3. ノイズリダクション（Transform stream）
+            const noiseReductionTransform = this.createNoiseReductionTransform();
+            // パイプライン構築: リサンプリング → ローパス → ノイズ除去
+            let pipeline = resampleTransform;
+            if (this.lowpassFilterEnabled) {
+                pipeline = pipeline.pipe(lowpassTransform);
+            }
+            if (this.noiseReductionEnabled) {
+                pipeline = pipeline.pipe(noiseReductionTransform);
+            }
+            // パイプラインの出力を収集
+            return new Promise((resolve, reject) => {
+                pipeline.on('data', (chunk) => {
+                    processedChunks.push(chunk);
+                });
+                pipeline.on('end', async () => {
+                    // すべての処理済みデータを結合
+                    const combinedBuffer = Buffer.concat(processedChunks);
+                    const int16Data = this.convertToInt16Array(new Uint8Array(combinedBuffer));
+                    // AudioOutputを遅延作成
+                    await this.ensureAudioOutput();
+                    // チャンクをキューに追加
+                    this.chunkQueue.push(int16Data);
+                    logger.debug(`処理済みチャンクをキューに追加、現在のキューサイズ: ${this.chunkQueue.length}`);
+                    resolve();
+                });
+                pipeline.on('error', (error) => {
+                    reject(new Error(`パイプライン処理エラー: ${error.message}`));
+                });
                 // PCMデータをパイプラインに送信
                 resampleTransform.write(Buffer.from(pcmData));
                 resampleTransform.end();
-            }
-            catch (error) {
-                logger.error(`パイプライン構築エラー: ${error.message}`);
-                reject(new Error(`パイプライン構築エラー: ${error.message}`));
-            }
-        });
+            });
+        }
+        catch (error) {
+            throw new Error(`パイプライン構築エラー: ${error.message}`);
+        }
     }
     /**
      * リサンプリング用Transform streamを作成
@@ -234,7 +247,6 @@ export class AudioPlayer {
         // 簡易的な線形補間によるリサンプリング実装
         const ratio = this.playbackRate / this.synthesisRate;
         logger.log(`リサンプリング: ${this.synthesisRate}Hz → ${this.playbackRate}Hz (比率: ${ratio})`);
-        let carryOverSample = null;
         return new Transform({
             transform: (chunk, encoding, callback) => {
                 try {
@@ -324,200 +336,154 @@ export class AudioPlayer {
             if (!this.isInitialized) {
                 throw new Error('AudioPlayer is not initialized');
             }
+            // 再生開始時に停止フラグをリセット
+            this.shouldStop = false;
+            // 新しい完了Promiseを作成
+            this.completionPromise = new OpenPromise();
             for await (const audioResult of audioStream) {
+                // チャンク境界で停止チェック
+                if (this.shouldStop) {
+                    logger.info('チャンク境界で再生を停止しました');
+                    break;
+                }
                 // PCMデータを抽出して即座に再生
                 await this.playAudioStream(audioResult, bufferSize);
             }
+            // すべてのチャンクが再生されるまで待機
+            await this.waitForCompletion();
         }
         catch (error) {
             throw new Error(`ストリーミング音声再生エラー: ${error.message}`);
         }
     }
     /**
-     * 並列ストリーミング再生（最初のチャンクから再生開始、以降は自動継続）
+     * キューが空になるまで待機（@echogarden/audio-io用）
      */
-    async playStreamingAudioParallel(audioStream) {
-        try {
-            if (!this.isInitialized) {
-                throw new Error('AudioPlayer is not initialized');
+    async waitForCompletion() {
+        if (!this.audioOutput)
+            return;
+        // キューが既に空の場合は即座に完了
+        if (this.chunkQueue.length === 0 && this.currentChunkOffset === 0) {
+            return;
+        }
+        // OpenPromiseがまだない場合は作成
+        if (!this.completionPromise || !this.completionPromise.isPending) {
+            this.completionPromise = new OpenPromise();
+        }
+        return this.completionPromise.promise;
+    }
+    /**
+     * @echogarden/audio-io用のaudioOutputを遅延作成
+     */
+    async ensureAudioOutput() {
+        if (!this.audioOutput) {
+            logger.debug('AudioOutput作成中...');
+            // bufferDurationの計算（latencyModeに基づく）
+            let bufferDuration;
+            switch (this.audioConfig.latencyMode) {
+                case 'ultra-low':
+                    bufferDuration = 20; // 20ms
+                    break;
+                case 'quality':
+                    bufferDuration = 200; // 200ms
+                    break;
+                default: // balanced
+                    bufferDuration = 100; // 100ms
             }
-            const playQueue = [];
-            for await (const audioResult of audioStream) {
-                // 各チャンクを非同期で再生（順序は保たない、低レイテンシ優先）
-                const playPromise = this.playAudioStream(audioResult).catch((error) => {
-                    logger.warn(`チャンク${audioResult.chunk.index}再生エラー:`, error);
-                });
-                playQueue.push(playPromise);
-                // 最大3チャンクまでの並列再生
-                if (playQueue.length >= 3) {
-                    await Promise.race(playQueue);
-                    // 完了したプロミスを削除
-                    const completedIndex = playQueue.findIndex(p => p === Promise.resolve());
-                    if (completedIndex !== -1) {
-                        playQueue.splice(completedIndex, 1);
-                    }
-                }
+            try {
+                this.audioOutput = await createAudioOutput({
+                    sampleRate: this.playbackRate,
+                    channelCount: this.channels,
+                    bufferDuration,
+                }, this.audioOutputHandler);
+                logger.info(`AudioOutput作成完了: ${this.playbackRate}Hz, ${this.channels}ch, buffer: ${bufferDuration}ms`);
+            }
+            catch (error) {
+                throw new Error(`AudioOutput作成エラー: ${error.message}`);
             }
-            // 残りのチャンクの再生完了を待機
-            await Promise.all(playQueue);
-        }
-        catch (error) {
-            throw new Error(`並列ストリーミング音声再生エラー: ${error.message}`);
         }
     }
     /**
-     * Speakerインスタンスを作成（環境変数によるモック対応）
+     * @echogarden/audio-io用のコールバックハンドラ
      */
-    async createSpeaker(sampleRate, bufferSize) {
-        logger.debug(`新しいSpeaker作成: ${sampleRate}Hz, ${this.channels}ch, ${this.bitDepth}bit, buffer:${bufferSize}`);
-        const config = {
-            channels: this.channels,
-            bitDepth: this.bitDepth,
-            sampleRate: sampleRate,
-            highWaterMark: bufferSize,
-        };
-        // テスト用のモックインスタンスが設定されている場合はそれを返す
-        if (forTests.mockSpeakerInstance) {
-            logger.debug('Using forTests.mockSpeakerInstance');
-            return forTests.mockSpeakerInstance;
-        }
-        // CI環境またはテスト環境でモックSpeakerを返す
-        const isTestEnv = process.env.NODE_ENV === 'test';
-        const isCIEnv = process.env.CI === 'true';
-        logger.debug(`Environment check - NODE_ENV: ${process.env.NODE_ENV}, CI: ${process.env.CI}, isTestEnv: ${isTestEnv}, isCIEnv: ${isCIEnv}`);
-        if (isTestEnv || isCIEnv) {
-            logger.debug('Using mock Speaker for test/CI environment');
-            const mockSpeaker = new EventEmitter();
-            // Writable Streamの基本メソッド
-            mockSpeaker.write = (chunk, encoding, callback) => {
-                const cb = typeof encoding === 'function' ? encoding : callback;
-                if (cb)
-                    cb();
-                return true;
-            };
-            mockSpeaker.end = (chunk, encoding, callback) => {
-                let cb;
-                if (typeof chunk === 'function') {
-                    cb = chunk;
+    audioOutputHandler = (outputBuffer) => {
+        let bufferOffset = 0;
+        while (bufferOffset < outputBuffer.length && !this.shouldStop) {
+            if (this.chunkQueue.length > 0) {
+                const currentChunk = this.chunkQueue[0];
+                const remainingInChunk = currentChunk.length - this.currentChunkOffset;
+                const remainingInBuffer = outputBuffer.length - bufferOffset;
+                const copyLength = Math.min(remainingInChunk, remainingInBuffer);
+                // データをコピー
+                outputBuffer.set(currentChunk.subarray(this.currentChunkOffset, this.currentChunkOffset + copyLength), bufferOffset);
+                bufferOffset += copyLength;
+                this.currentChunkOffset += copyLength;
+                // チャンクを使い切ったら次へ
+                if (this.currentChunkOffset >= currentChunk.length) {
+                    this.chunkQueue.shift();
+                    this.currentChunkOffset = 0;
+                    logger.debug(`チャンク消費完了、残りキュー: ${this.chunkQueue.length}`);
                 }
-                else if (typeof encoding === 'function') {
-                    cb = encoding;
-                }
-                else {
-                    cb = callback;
-                }
-                // endが呼ばれたら少し遅延してcloseイベントを発火
-                setImmediate(() => {
-                    mockSpeaker.emit('close');
-                });
-                if (cb)
-                    cb();
-            };
-            // EventEmitterのメソッド
-            mockSpeaker.removeAllListeners = () => mockSpeaker;
-            // pipe関連のメソッド（Transform Streamとの連携用）
-            mockSpeaker.pipe = (destination) => destination;
-            mockSpeaker.unpipe = () => mockSpeaker;
-            // Writable Streamの状態
-            mockSpeaker._writableState = { ended: false };
-            mockSpeaker.writable = true;
-            mockSpeaker.destroyed = false;
-            // destroyメソッド（リソース解放用）
-            mockSpeaker.destroy = (error) => {
-                mockSpeaker.destroyed = true;
-                if (error) {
-                    mockSpeaker.emit('error', error);
+            }
+            else {
+                // キューが空なら無音で埋める
+                outputBuffer.fill(0, bufferOffset);
+                // キューが空になったら完了を通知
+                if (this.completionPromise && this.completionPromise.isPending) {
+                    this.completionPromise.resolve();
                 }
-                mockSpeaker.emit('close');
-            };
-            return mockSpeaker;
+                break;
+            }
         }
-        // 本番環境では実際のSpeakerを動的インポート
-        try {
-            logger.debug('Dynamically importing real Speaker (production mode)');
-            const SpeakerModule = await import('speaker');
-            const SpeakerClass = SpeakerModule.default || SpeakerModule;
-            return new SpeakerClass(config);
+        // 停止フラグが立っていたら無音で埋める
+        if (this.shouldStop) {
+            outputBuffer.fill(0, bufferOffset);
+            // 停止時も完了を通知
+            if (this.completionPromise && this.completionPromise.isPending) {
+                this.completionPromise.resolve();
+            }
         }
-        catch (error) {
-            logger.error(`Failed to import Speaker module: ${error.message}`);
-            // CI環境でSpeakerがロードできない場合はモックを返す
-            logger.debug('Falling back to mock Speaker due to import failure');
-            const mockSpeaker = new EventEmitter();
-            // Writable Streamの基本メソッド
-            mockSpeaker.write = (chunk, encoding, callback) => {
-                const cb = typeof encoding === 'function' ? encoding : callback;
-                if (cb)
-                    cb();
-                return true;
-            };
-            mockSpeaker.end = (chunk, encoding, callback) => {
-                let cb;
-                if (typeof chunk === 'function') {
-                    cb = chunk;
-                }
-                else if (typeof encoding === 'function') {
-                    cb = encoding;
-                }
-                else {
-                    cb = callback;
-                }
-                // endが呼ばれたら少し遅延してcloseイベントを発火
-                setImmediate(() => {
-                    mockSpeaker.emit('close');
-                });
-                if (cb)
-                    cb();
-            };
-            mockSpeaker.removeAllListeners = () => mockSpeaker;
-            mockSpeaker.pipe = (destination) => destination;
-            mockSpeaker.unpipe = () => mockSpeaker;
-            mockSpeaker._writableState = { ended: false };
-            mockSpeaker.writable = true;
-            mockSpeaker.destroyed = false;
-            mockSpeaker.destroy = (error) => {
-                mockSpeaker.destroyed = true;
-                if (error) {
-                    mockSpeaker.emit('error', error);
-                }
-                mockSpeaker.emit('close');
-            };
-            return mockSpeaker;
+    };
+    /**
+     * Uint8ArrayからInt16Arrayに変換（リトルエンディアン）
+     */
+    convertToInt16Array(pcmData) {
+        const int16Data = new Int16Array(pcmData.length / 2);
+        for (let i = 0; i < int16Data.length; i++) {
+            const low = pcmData[i * 2];
+            const high = pcmData[i * 2 + 1];
+            // リトルエンディアンで16bit整数を構築
+            int16Data[i] = (high << 8) | low;
+            // 符号付き整数に変換（-32768 ~ 32767）
+            if (int16Data[i] >= 32768) {
+                int16Data[i] -= 65536;
+            }
         }
+        return int16Data;
     }
     /**
-     * PCMデータを直接スピーカーに再生（改善版：Speakerインスタンス使い回し）
-     * synthesis/playbackレートが異なる場合は適切なSpeaker設定を使用
+     * PCMデータを音声出力キューに追加
      */
     async playPCMData(pcmData, bufferSize, chunk) {
-        // synthesisRateとplaybackRateが異なる場合は、実際の生成レートを使用
-        const actualSampleRate = this.synthesisRate === this.playbackRate ? this.playbackRate : this.synthesisRate;
-        const finalBufferSize = bufferSize || BUFFER_SIZES.DEFAULT;
-        // Speakerインスタンスを新規作成
-        const speaker = await this.createSpeaker(actualSampleRate, finalBufferSize);
-        return new Promise((resolve, reject) => {
-            // 一時的なイベントリスナーを設定（既存リスナーと競合しないようonce使用）
-            speaker.once('close', () => {
-                logger.debug('Speaker close event received');
-                resolve();
-            });
-            speaker.once('error', (error) => {
-                logger.error(`Speaker再生エラー: ${error.message}`);
-                reject(error);
-            });
-            // クロスフェード処理を適用（設定に基づく）
-            let processedData = pcmData;
-            const crossfadeEnabled = this.audioConfig.crossfadeSettings?.enabled && chunk;
-            if (crossfadeEnabled) {
-                const skipFirst = this.audioConfig.crossfadeSettings?.skipFirstChunk && chunk?.isFirst;
-                if (!skipFirst) {
-                    const overlapSamples = this.audioConfig.crossfadeSettings?.overlapSamples || 24;
-                    processedData = this.applyCrossfade(pcmData, overlapSamples, chunk?.isFirst || false);
-                }
+        // AudioOutputを遅延作成
+        await this.ensureAudioOutput();
+        // クロスフェード処理を適用（設定に基づく）
+        let processedData = pcmData;
+        const crossfadeEnabled = this.audioConfig.crossfadeSettings?.enabled && chunk;
+        if (crossfadeEnabled) {
+            const skipFirst = this.audioConfig.crossfadeSettings?.skipFirstChunk && chunk?.isFirst;
+            if (!skipFirst) {
+                const overlapSamples = this.audioConfig.crossfadeSettings?.overlapSamples || 24;
+                processedData = this.applyCrossfade(pcmData, overlapSamples, chunk?.isFirst || false);
             }
-            // PCMデータをスピーカーに書き込み
-            speaker.end(Buffer.from(processedData));
-        });
+        }
+        // PCMデータをInt16Arrayに変換
+        const int16Data = this.convertToInt16Array(processedData);
+        // チャンクをキューに追加
+        this.chunkQueue.push(int16Data);
+        logger.debug(`チャンクをキューに追加、現在のキューサイズ: ${this.chunkQueue.length}`);
+        // コールバックベースなので、ここでは追加のみ
+        // 実際の再生はaudioOutputHandlerで処理される
     }
     /**
      * 音声ファイルを保存
@@ -684,6 +650,17 @@ export class AudioPlayer {
             // エラーが発生しても処理を継続（ウォームアップは補助機能）
         }
     }
+    /**
+     * 音声再生の停止（チャンク境界で停止）
+     * 現在再生中のチャンクは最後まで再生され、次のチャンクから停止します
+     */
+    async stopPlayback() {
+        logger.info('音声再生の停止要求を受信しました');
+        this.shouldStop = true;
+        // キューをクリア
+        this.chunkQueue = [];
+        this.currentChunkOffset = 0;
+    }
     /**
      * AudioPlayerのクリーンアップ（リソース解放）
      * 長時間運用やシャットダウン時に呼び出し
@@ -691,6 +668,13 @@ export class AudioPlayer {
     async cleanup() {
         logger.debug('AudioPlayer cleanup開始');
         try {
+            // AudioOutputの破棄
+            if (this.audioOutput) {
+                await this.audioOutput.dispose();
+                this.audioOutput = null;
+                this.chunkQueue = [];
+                this.currentChunkOffset = 0;
+            }
             // Echogardenリソースの解放
             if (this.echogardenInitialized) {
                 // Echogardenには明示的なクリーンアップメソッドがないため、フラグのみリセット