@kajidog/mcp-tts-voicevox 0.0.6 → 0.0.7

package/README.md

@@ -2,81 +2,63 @@
 
 VOICEVOXを使用した音声合成MCPサーバー
 
+## 特徴
+
+- **キュー管理機能** - 複数の音声合成リクエストを効率的に処理
+- **プリフェッチ** - 次の音声を事前に生成し、再生をスムーズに
+
 ## 必要条件
 
 - Node.js
 - [VOICEVOXエンジン](https://voicevox.hiroshiba.jp/)
 
-## 機能概要
-
-- テキストから音声を合成して再生
-- テキストから音声合成用クエリを生成
-- 音声合成用クエリから音声ファイルを生成
-- テキストまたはクエリを音声生成キューに追加
-
-## 使い方
-
-### インストール
+## インストール
 
 ```bash
 npm install -g @kajidog/mcp-tts-voicevox
 ```
 
-### 実行
+## 使い方
+
+### MCPサーバーとして
 
 1. VOICEVOXエンジンを起動
-2. 以下のコマンドを実行
+2. MCPサーバーを起動
 
 ```bash
 npx @kajidog/mcp-tts-voicevox
 ```
 
-### MCPツールとして使用
+### ライブラリとして
 
-#### 1. テキストを音声に変換して再生
+プロジェクトに直接インポートして使用することも可能です：
 
-```typescript
-await mcp.invoke("speak", {
-  text: "こんにちは！",  // 読み上げるテキスト
-  speaker: 1  // 話者ID（オプション）
-});
+```bash
+npm install @kajidog/mcp-tts-voicevox
 ```
 
-#### 2. テキストから音声合成用クエリを生成
+```javascript
+import { VoicevoxClient } from "@kajidog/mcp-tts-voicevox";
 
-```typescript
-const queryResult = await mcp.invoke("generate_query", {
-  text: "こんにちは！",  // 音声合成するテキスト
-  speaker: 1  // 話者ID（オプション）
+// クライアントを初期化
+const client = new VoicevoxClient({
+  url: "http://localhost:50021", // VOICEVOXエンジンのURL
+  defaultSpeaker: 1,             // デフォルト話者ID（オプション）
+  defaultSpeedScale: 1.0         // デフォルト速度（オプション）
 });
 
-// 返されたテキストをJSONにパース
-const query = JSON.parse(queryResult.content[0].text);
-```
-
-#### 3. 音声合成用クエリから音声ファイルを生成
+// テキストを音声に変換して再生
+await client.speak("こんにちは");
 
-```typescript
-const fileResult = await mcp.invoke("synthesize_file", {
-  query: query,  // 音声合成用クエリ
-  output: "/path/to/output.wav",  // 出力ファイルパス
-  speaker: 1  // 話者ID（オプション）
-});
-
-// 生成された音声ファイルのパス
-const filePath = fileResult.content[0].text;
+// テキストから音声ファイルを生成
+const filePath = await client.generateAudioFile("こんにちは", "./output.wav");
 ```
 
-## 活用例
-
-1. **テキストを直接音声に変換**
-   - `speak` - 短いテキストをすぐに読み上げたいとき
-
-2. **細かい音声設定をカスタマイズ**
-   - `generate_query` → クエリ編集 → `synthesize_file` の流れで高度な調整が可能
+## 主な機能
 
-3. **バッチ処理で大量の音声ファイルを作成**
-   - テキストをクエリに変換してから一括で音声ファイルを生成
+- **テキスト読み上げ** (`speak`) - テキストを音声に変換して再生
+- **クエリ生成** (`generate_query`) - 音声合成用クエリの作成
+- **ファイル生成** (`synthesize_file`) - クエリから音声ファイルを生成
 
 ## 環境変数
 

package/dist/index.js

@@ -10,7 +10,7 @@ const types_1 = require("./voicevox/types");
 Object.defineProperty(exports, "VoicevoxError", { enumerable: true, get: function () { return types_1.VoicevoxError; } });
 const server = new mcp_js_1.McpServer({
     name: "MCP TTS Voicevox",
-    version: "0.0.6",
+    version: "0.0.7",
     description: "A Voicevox server that converts text to speech for playback and saving.",
 });
 // VoicevoxClientを一度だけインスタンス化

package/dist/voicevox/api.js

@@ -16,7 +16,7 @@ class VoicevoxApi {
      */
     async generateQuery(text, speaker = 1) {
         try {
-            const endpoint = `/audio_query?text=${encodeURIComponent(text)}&speaker=${speaker}`;
+            const endpoint = `/audio_query?text=${encodeURIComponent(text)}&speaker=${encodeURIComponent(speaker.toString())}`;
             const query = await this.makeRequest("post", endpoint, null, {
                 "Content-Type": "application/json",
             });
@@ -31,7 +31,7 @@ class VoicevoxApi {
      */
     async synthesize(query, speaker = 1) {
         try {
-            return await this.makeRequest("post", `/synthesis?speaker=${speaker}`, query, {
+            return await this.makeRequest("post", `/synthesis?speaker=${encodeURIComponent(speaker.toString())}`, query, {
                 "Content-Type": "application/json",
                 Accept: "audio/wav",
             }, "arraybuffer");
@@ -45,7 +45,7 @@ class VoicevoxApi {
      */
     async generateQueryFromPreset(text, presetId, coreVersion) {
         try {
-            let endpoint = `/audio_query_from_preset?text=${encodeURIComponent(text)}&preset_id=${presetId}`;
+            let endpoint = `/audio_query_from_preset?text=${encodeURIComponent(text)}&preset_id=${encodeURIComponent(presetId.toString())}`;
             if (coreVersion) {
                 endpoint += `&core_version=${encodeURIComponent(coreVersion)}`;
             }

package/dist/voicevox/error.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorHandler = exports.VoicevoxError = exports.VoicevoxErrorCode = void 0;
 exports.handleError = handleError;
 exports.formatError = formatError;
 /**
@@ -24,3 +25,91 @@ function formatError(message, error) {
     console.error(`${message}: ${errorMsg}`, error);
     return `${message}: ${errorMsg}`;
 }
+/**
+ * VOICEVOX関連のエラーコード
+ */
+var VoicevoxErrorCode;
+(function (VoicevoxErrorCode) {
+    VoicevoxErrorCode["API_CONNECTION_ERROR"] = "api_connection_error";
+    VoicevoxErrorCode["QUERY_GENERATION_ERROR"] = "query_generation_error";
+    VoicevoxErrorCode["SYNTHESIS_ERROR"] = "synthesis_error";
+    VoicevoxErrorCode["FILE_OPERATION_ERROR"] = "file_operation_error";
+    VoicevoxErrorCode["PLAYBACK_ERROR"] = "playback_error";
+    VoicevoxErrorCode["QUEUE_OPERATION_ERROR"] = "queue_operation_error";
+    VoicevoxErrorCode["UNKNOWN_ERROR"] = "unknown_error";
+})(VoicevoxErrorCode || (exports.VoicevoxErrorCode = VoicevoxErrorCode = {}));
+/**
+ * VOICEVOXエラークラス
+ */
+class VoicevoxError extends Error {
+    constructor(message, code = VoicevoxErrorCode.UNKNOWN_ERROR, originalError) {
+        super(message);
+        this.name = "VoicevoxError";
+        this.code = code;
+        this.originalError = originalError;
+    }
+    /**
+     * エラー発生箇所とスタックトレースを含むエラーの詳細情報を取得
+     */
+    getDetailedMessage() {
+        let details = `${this.message} [${this.code}]`;
+        if (this.originalError instanceof Error) {
+            details += `\nOriginal Error: ${this.originalError.message}`;
+            if (this.originalError.stack) {
+                details += `\nStack: ${this.originalError.stack}`;
+            }
+        }
+        return details;
+    }
+}
+exports.VoicevoxError = VoicevoxError;
+/**
+ * エラーハンドリングユーティリティクラス
+ * アプリケーション全体で統一されたエラーハンドリングを提供
+ */
+class ErrorHandler {
+    /**
+     * エラーをVoicevoxError形式に変換して例外をスロー
+     */
+    static throw(message, code = VoicevoxErrorCode.UNKNOWN_ERROR, originalError) {
+        console.error(`[${code}] ${message}`, originalError);
+        throw new VoicevoxError(message, code, originalError);
+    }
+    /**
+     * APIエラーを処理
+     */
+    static handleApiError(message, error) {
+        return this.throw(message, VoicevoxErrorCode.API_CONNECTION_ERROR, error);
+    }
+    /**
+     * クエリ生成エラーを処理
+     */
+    static handleQueryGenerationError(message, error) {
+        return this.throw(message, VoicevoxErrorCode.QUERY_GENERATION_ERROR, error);
+    }
+    /**
+     * 音声合成エラーを処理
+     */
+    static handleSynthesisError(message, error) {
+        return this.throw(message, VoicevoxErrorCode.SYNTHESIS_ERROR, error);
+    }
+    /**
+     * ファイル操作エラーを処理
+     */
+    static handleFileError(message, error) {
+        return this.throw(message, VoicevoxErrorCode.FILE_OPERATION_ERROR, error);
+    }
+    /**
+     * 再生エラーを処理
+     */
+    static handlePlaybackError(message, error) {
+        return this.throw(message, VoicevoxErrorCode.PLAYBACK_ERROR, error);
+    }
+    /**
+     * キュー操作エラーを処理
+     */
+    static handleQueueError(message, error) {
+        return this.throw(message, VoicevoxErrorCode.QUEUE_OPERATION_ERROR, error);
+    }
+}
+exports.ErrorHandler = ErrorHandler;

package/dist/voicevox/index.js

@@ -18,12 +18,14 @@ exports.VoicevoxClient = void 0;
 const player_1 = require("./player");
 const utils_1 = require("./utils");
 const error_1 = require("./error");
+const api_1 = require("./api");
 class VoicevoxClient {
     constructor(config) {
         this.validateConfig(config);
         this.defaultSpeaker = config.defaultSpeaker ?? 1;
         this.defaultSpeedScale = config.defaultSpeedScale ?? 1.0;
         this.maxSegmentLength = 150;
+        this.api = new api_1.VoicevoxApi(config.url);
         this.player = new player_1.VoicevoxPlayer(config.url);
     }
     /**
@@ -38,10 +40,30 @@ class VoicevoxClient {
             const speakerId = this.getSpeakerId(speaker);
             const speed = this.getSpeedScale(speedScale);
             const segments = (0, utils_1.splitText)(text, this.maxSegmentLength);
-            for (const segment of segments) {
-                const query = await this.player.generateQuery(segment, speakerId);
-                query.speedScale = speed;
-                await this.player.enqueueWithQuery(query, speakerId);
+            const queueManager = this.player.getQueueManager();
+            if (segments.length === 0) {
+                return "テキストが空です";
+            }
+            // 最初のセグメントを優先的に処理して再生を早く開始
+            if (segments.length > 0) {
+                const firstQuery = await this.generateQuery(segments[0], speakerId);
+                firstQuery.speedScale = speed;
+                await queueManager.enqueueQuery(firstQuery, speakerId);
+            }
+            // 残りのセグメントは非同期で処理
+            if (segments.length > 1) {
+                // 残りのセグメントを非同期で処理する関数
+                const processRemainingSegments = async () => {
+                    for (let i = 1; i < segments.length; i++) {
+                        const query = await this.generateQuery(segments[i], speakerId);
+                        query.speedScale = speed;
+                        await queueManager.enqueueQuery(query, speakerId);
+                    }
+                };
+                // 非同期で開始するが結果を待たない
+                processRemainingSegments().catch((error) => {
+                    console.error("残りのセグメント処理中にエラーが発生しました:", error);
+                });
             }
             return `音声生成キューに追加しました: ${text}`;
         }
@@ -59,7 +81,8 @@ class VoicevoxClient {
     async generateQuery(text, speaker, speedScale) {
         try {
             const speakerId = this.getSpeakerId(speaker);
-            const query = await this.player.generateQuery(text, speakerId);
+            // 直接APIを使用してクエリを生成
+            const query = await this.api.generateQuery(text, speakerId);
             query.speedScale = this.getSpeedScale(speedScale);
             return query;
         }
@@ -79,14 +102,33 @@ class VoicevoxClient {
         try {
             const speakerId = this.getSpeakerId(speaker);
             const speed = this.getSpeedScale(speedScale);
+            // キューマネージャーにアクセス
+            const queueManager = this.player.getQueueManager();
             if (typeof textOrQuery === "string") {
+                // テキストからクエリを生成
                 const query = await this.generateQuery(textOrQuery, speakerId);
                 query.speedScale = speed;
-                return await this.player.synthesizeToFile(query, outputPath, speakerId);
+                // 直接APIで音声合成
+                const audioData = await this.api.synthesize(query, speakerId);
+                // 一時ファイル保存またはパス指定の保存
+                if (!outputPath) {
+                    return await queueManager.saveTempAudioFile(audioData);
+                }
+                else {
+                    return await this.player.synthesizeToFile(query, outputPath, speakerId);
+                }
             }
             else {
+                // クエリを使って音声合成
                 const query = { ...textOrQuery, speedScale: speed };
-                return await this.player.synthesizeToFile(query, outputPath, speakerId);
+                const audioData = await this.api.synthesize(query, speakerId);
+                // 一時ファイル保存またはパス指定の保存
+                if (!outputPath) {
+                    return await queueManager.saveTempAudioFile(audioData);
+                }
+                else {
+                    return await this.player.synthesizeToFile(query, outputPath, speakerId);
+                }
             }
         }
         catch (error) {
@@ -98,12 +140,40 @@ class VoicevoxClient {
         try {
             const speakerId = this.getSpeakerId(speaker);
             const speed = this.getSpeedScale(speedScale);
+            const queueManager = this.player.getQueueManager();
             if (typeof textOrQuery === "string") {
-                return await this.speak(textOrQuery, speakerId, speed);
+                // テキストの場合：分割して処理
+                const segments = (0, utils_1.splitText)(textOrQuery, this.maxSegmentLength);
+                if (segments.length === 0) {
+                    return "テキストが空です";
+                }
+                // 最初のセグメントを優先処理
+                if (segments.length > 0) {
+                    const firstQuery = await this.generateQuery(segments[0], speakerId);
+                    firstQuery.speedScale = speed;
+                    await queueManager.enqueueQuery(firstQuery, speakerId);
+                }
+                // 残りのセグメントは非同期で処理
+                if (segments.length > 1) {
+                    // 非同期で処理する関数
+                    const processRemainingSegments = async () => {
+                        for (let i = 1; i < segments.length; i++) {
+                            const query = await this.generateQuery(segments[i], speakerId);
+                            query.speedScale = speed;
+                            await queueManager.enqueueQuery(query, speakerId);
+                        }
+                    };
+                    // 非同期で開始するが結果を待たない
+                    processRemainingSegments().catch((error) => {
+                        console.error("残りのセグメント処理中にエラーが発生しました:", error);
+                    });
+                }
+                return `テキストをキューに追加しました: ${textOrQuery}`;
             }
             else {
+                // クエリをキューに追加
                 const query = { ...textOrQuery, speedScale: speed };
-                await this.player.enqueueWithQuery(query, speakerId);
+                await queueManager.enqueueQuery(query, speakerId);
                 return "クエリをキューに追加しました";
             }
         }

package/dist/voicevox/player.js

@@ -1,47 +1,18 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VoicevoxPlayer = void 0;
 const queue_1 = require("./queue");
 const error_1 = require("./error");
 const api_1 = require("./api");
-const fsPromises = __importStar(require("fs/promises"));
-const path_1 = require("path");
-const promises_1 = require("fs/promises");
-const uuid_1 = require("uuid");
-const os_1 = require("os");
+/**
+ * エラーハンドラープロキシ
+ * メソッドをエラーハンドリングで包む高階関数
+ */
+function withErrorHandling(method, errorMessage) {
+    return method().catch((error) => {
+        throw (0, error_1.handleError)(errorMessage, error);
+    });
+}
 /**
  * VOICEVOX音声プレイヤークラス
  * キュー管理システムを使用して音声の合成と再生を行う
@@ -54,9 +25,9 @@ class VoicevoxPlayer {
      */
     constructor(voicevoxUrl = "http://localhost:50021", prefetchSize = 2) {
         // APIインスタンスを作成
-        this.api = new api_1.VoicevoxApi(voicevoxUrl);
+        const api = new api_1.VoicevoxApi(voicevoxUrl);
         // キューマネージャーにAPIインスタンスを注入
-        this.queueManager = new queue_1.VoicevoxQueueManager(this.api, prefetchSize);
+        this.queueManager = new queue_1.VoicevoxQueueManager(api, prefetchSize);
         // デフォルトで再生を開始
         this.queueManager.startPlayback();
         // エラーイベントのログ記録
@@ -72,12 +43,9 @@ class VoicevoxPlayer {
      * @param speaker 話者ID
      */
     async enqueue(text, speaker = 1) {
-        try {
+        return withErrorHandling(async () => {
             await this.queueManager.enqueueText(text, speaker);
-        }
-        catch (error) {
-            (0, error_1.handleError)("キューへの追加中にエラーが発生しました", error);
-        }
+        }, "テキストのキュー追加中にエラーが発生しました");
     }
     /**
      * クエリを使ってキューに追加
@@ -85,127 +53,65 @@ class VoicevoxPlayer {
      * @param speaker 話者ID
      */
     async enqueueWithQuery(query, speaker = 1) {
-        try {
+        return withErrorHandling(async () => {
             await this.queueManager.enqueueQuery(query, speaker);
-        }
-        catch (error) {
-            (0, error_1.handleError)("クエリからの音声生成中にエラーが発生しました", error);
-        }
+        }, "クエリのキュー追加中にエラーが発生しました");
     }
     /**
      * テキストから音声合成用クエリを生成
+     * キューマネージャーの内部機能を使用
      * @param text 合成するテキスト
      * @param speaker 話者ID
      */
     async generateQuery(text, speaker = 1) {
-        try {
-            // 一時的にキューにテキストを追加してクエリを取得
-            const item = await this.queueManager.enqueueText(text, speaker);
-            // クエリが生成されるまで待機
-            const maxRetries = 40;
-            const retryInterval = 500;
-            let retryCount = 0;
-            return await new Promise((resolve, reject) => {
-                const checkQuery = () => {
-                    const status = this.queueManager.getItemStatus(item.id);
-                    const currentItem = this.queueManager
-                        .getQueue()
-                        .find((i) => i.id === item.id);
-                    if (currentItem?.query) {
-                        // クエリが取得できたらキューから削除して返す
-                        const query = { ...currentItem.query };
-                        this.queueManager.removeItem(item.id);
-                        resolve(query);
-                        return;
-                    }
-                    if (status === queue_1.QueueItemStatus.ERROR) {
-                        this.queueManager.removeItem(item.id);
-                        reject(new Error("クエリの生成に失敗しました"));
-                        return;
-                    }
-                    if (retryCount >= maxRetries) {
-                        this.queueManager.removeItem(item.id);
-                        reject(new Error("クエリの生成がタイムアウトしました"));
-                        return;
-                    }
-                    retryCount++;
-                    setTimeout(checkQuery, retryInterval);
-                };
-                checkQuery();
-            });
-        }
-        catch (error) {
-            throw (0, error_1.handleError)("音声クエリ生成中にエラーが発生しました", error);
-        }
+        return withErrorHandling(async () => {
+            // AudioGeneratorのgenerateQueryを直接呼び出す
+            return await this.queueManager
+                .getAudioGenerator()
+                .generateQuery(text, speaker);
+        }, "音声合成クエリの生成中にエラーが発生しました");
     }
     /**
      * 音声合成用クエリから音声ファイルを生成
+     * 重複を避けるためにQueueManagerの機能に委譲
+     *
      * @param query 音声合成用クエリ
      * @param output 出力ファイルパスまたは出力ディレクトリ（省略時は一時ディレクトリに生成）
      * @param speaker 話者ID
      */
     async synthesizeToFile(query, output, speaker = 1) {
-        try {
-            // クエリから直接音声を合成（キューを使わない）
-            const audioData = await this.api.synthesize(query, speaker);
-            // outputが未定義または空文字列の場合は、一時ディレクトリにファイルを作成
+        return withErrorHandling(async () => {
+            // クエリから音声を合成
+            const api = this.queueManager.getApi();
+            const audioData = await api.synthesize(query, speaker);
+            // ファイル保存処理をFileManagerに完全に委譲
+            const fileManager = this.queueManager.getFileManager();
+            // 出力パスが指定されていない場合は一時ファイル、指定されている場合は指定パスに保存
             if (!output) {
-                const tempFilePath = this.createTempFilePath();
-                await fsPromises.writeFile(tempFilePath, Buffer.from(audioData));
-                return tempFilePath;
+                return await fileManager.saveTempAudioFile(audioData);
             }
-            // 出力が実際にディレクトリかファイルパスか判断
-            let targetPath = output;
-            let isDir = false;
-            try {
-                const outputStat = await (0, promises_1.stat)(output);
-                isDir = outputStat.isDirectory();
+            else {
+                return await fileManager.saveAudioFile(audioData, output);
             }
-            catch (err) {
-                // ファイルまたはディレクトリが存在しない場合
-                // 末尾がスラッシュで終わる場合はディレクトリと見なす
-                isDir = output.endsWith("/") || output.endsWith("\\");
-            }
-            // ディレクトリの場合、ファイル名を生成
-            if (isDir) {
-                const filename = `voice-${(0, uuid_1.v4)()}.wav`;
-                targetPath = (0, path_1.join)(output, filename);
-            }
-            // 出力ディレクトリが存在するか確認し、存在しない場合は作成
-            await fsPromises.mkdir((0, path_1.dirname)(targetPath), { recursive: true });
-            // 音声データを指定された出力先に書き込み
-            await fsPromises.writeFile(targetPath, Buffer.from(audioData));
-            return targetPath;
-        }
-        catch (error) {
-            throw (0, error_1.handleError)("音声ファイル生成中にエラーが発生しました", error);
-        }
+        }, "音声ファイル生成中にエラーが発生しました");
     }
     /**
-     * 一時ファイルのパスを生成
-     * @returns 一時ファイルのパス
+     * 再生を開始
      */
-    createTempFilePath() {
-        const uniqueFilename = `voicevox-${(0, uuid_1.v4)()}.wav`;
-        return (0, path_1.join)((0, os_1.tmpdir)(), uniqueFilename);
-    }
-    /**
-     * キューをクリア
-     */
-    clearQueue() {
-        this.queueManager.clearQueue();
+    startPlayback() {
+        this.queueManager.startPlayback();
     }
     /**
      * 再生を一時停止
      */
     pausePlayback() {
-        return this.queueManager.pausePlayback();
+        this.queueManager.pausePlayback();
     }
     /**
      * 再生を再開
      */
     resumePlayback() {
-        return this.queueManager.resumePlayback();
+        this.queueManager.resumePlayback();
     }
     /**
      * キュー内のアイテム数を取得
@@ -214,17 +120,25 @@ class VoicevoxPlayer {
         return this.queueManager.getQueue().length;
     }
     /**
-     * イベントリスナーを追加
-     * キュー管理システムからのイベントを監視できるようにする
+     * キューが空かどうかを確認
+     */
+    isQueueEmpty() {
+        return this.queueManager.getQueue().length === 0;
+    }
+    /**
+     * キューが再生中かどうかを確認
      */
-    addEventListener(event, listener) {
-        this.queueManager.addEventListener(event, listener);
+    isPlaying() {
+        return this.queueManager
+            .getQueue()
+            .some((item) => item.status === queue_1.QueueItemStatus.PLAYING);
     }
     /**
-     * イベントリスナーを削除
+     * キューマネージャーインスタンスを取得
+     * 高度な操作のため公開
      */
-    removeEventListener(event, listener) {
-        this.queueManager.removeEventListener(event, listener);
+    getQueueManager() {
+        return this.queueManager;
     }
 }
 exports.VoicevoxPlayer = VoicevoxPlayer;