@kajidog/voicevox-client 0.0.3-pre.4 → 0.3.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2024 kajidog
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE. 

package/README.md

@@ -21,10 +21,17 @@ const client = new VoicevoxClient({
 });
 
 // Simple text-to-speech
-await client.speak('こんにちは');
+await client.speak('Hello, world!');
+
+// With options
+await client.speak('Hello, world!', {
+  speaker: 3,
+  speedScale: 1.2,
+  waitForEnd: true  // Wait for playback to complete
+});
 
 // Generate audio file
-const filePath = await client.generateAudioFile('テストメッセージ', './output.wav');
+const filePath = await client.generateAudioFile('Test message', './output.wav');
 
 // Get available speakers
 const speakers = await client.getSpeakers();
@@ -34,6 +41,7 @@ const speakers = await client.getSpeakers();
 
 - **Text-to-Speech Synthesis**: Convert text to speech with multiple speaker voices
 - **Audio Queue Management**: Efficient queue-based audio processing and playback
+- **Streaming Playback**: Direct buffer playback via ffplay (no temp files)
 - **Cross-platform Audio Playback**: Native audio playback support without external dependencies
   - **macOS**: Uses built-in `afplay` command
   - **Windows**: Uses PowerShell MediaPlayer with optimized timing
@@ -41,6 +49,7 @@ const speakers = await client.getSpeakers();
 - **File Generation**: Generate WAV audio files from text
 - **Speaker Management**: Get information about available speakers and voices
 - **Flexible Input**: Support for single text, text arrays, and speech segments
+- **Advanced Playback Control**: Immediate playback, synchronous/asynchronous control
 - **Lightweight**: No external audio dependencies - uses platform-native tools
 
 ## API Reference
@@ -50,18 +59,160 @@ const speakers = await client.getSpeakers();
 Main client class for interacting with VOICEVOX engine.
 
 #### Constructor
+
 ```typescript
 new VoicevoxClient(config: VoicevoxConfig)
 ```
 
+**VoicevoxConfig:**
+
+```typescript
+interface VoicevoxConfig {
+  url: string;                           // VOICEVOX engine URL
+  defaultSpeaker?: number;               // Default speaker ID (default: 1)
+  defaultSpeedScale?: number;            // Default playback speed (default: 1.0)
+  defaultPlaybackOptions?: PlaybackOptions;  // Default playback options
+}
+```
+
 #### Methods
 
-- `speak(text: string | string[] | SpeechSegment[], speaker?: number, speedScale?: number): Promise<string>`
-- `generateQuery(text: string, speaker?: number, speedScale?: number): Promise<AudioQuery>`
-- `generateAudioFile(textOrQuery: string | AudioQuery, outputPath?: string, speaker?: number, speedScale?: number): Promise<string>`
-- `getSpeakers(): Promise<Speaker[]>`
-- `getSpeakerInfo(uuid: string): Promise<SpeakerInfo>`
-- `clearQueue(): Promise<void>`
+##### speak
+
+Convert text to speech and play it.
+
+```typescript
+speak(
+  input: string | string[] | SpeechSegment[],
+  options?: SpeakOptions
+): Promise<string>
+```
+
+**SpeakOptions:**
+
+```typescript
+interface SpeakOptions {
+  speaker?: number;        // Speaker ID
+  speedScale?: number;     // Playback speed
+  immediate?: boolean;     // Start playback immediately (default: true)
+  waitForStart?: boolean;  // Wait for playback to start (default: false)
+  waitForEnd?: boolean;    // Wait for playback to end (default: false)
+}
+```
+
+**Examples:**
+
+```typescript
+// Simple text
+await client.speak('Hello');
+
+// Multiple texts as array
+await client.speak(['Hello', 'How are you?']);
+
+// Speech segments with different speakers
+await client.speak([
+  { text: 'Hello', speaker: 1 },
+  { text: 'Nice to meet you', speaker: 3 }
+]);
+
+// With options
+await client.speak('Important message', {
+  speaker: 2,
+  speedScale: 1.5,
+  immediate: true,
+  waitForEnd: true
+});
+```
+
+##### generateQuery
+
+Generate an AudioQuery for voice synthesis.
+
+```typescript
+generateQuery(
+  text: string,
+  speaker?: number,
+  speedScale?: number
+): Promise<AudioQuery>
+```
+
+##### generateAudioFile
+
+Generate an audio file from text or AudioQuery.
+
+```typescript
+generateAudioFile(
+  textOrQuery: string | AudioQuery,
+  outputPath?: string,
+  speaker?: number,
+  speedScale?: number
+): Promise<string>
+```
+
+##### enqueueAudioGeneration
+
+Add text or query to the audio generation queue.
+
+```typescript
+enqueueAudioGeneration(
+  input: string | string[] | SpeechSegment[] | AudioQuery,
+  options?: SpeakOptions
+): Promise<string>
+```
+
+##### Other Methods
+
+- `getSpeakers(): Promise<Speaker[]>` - Get list of available speakers
+- `getSpeakerInfo(uuid: string): Promise<SpeakerInfo>` - Get speaker details
+- `clearQueue(): Promise<void>` - Clear the playback queue
+- `startPlayback(): void` - Start queue playback
+- `pausePlayback(): void` - Pause queue playback
+- `resumePlayback(): void` - Resume queue playback
+- `getQueueLength(): number` - Get number of items in queue
+- `isQueueEmpty(): boolean` - Check if queue is empty
+- `isPlaying(): boolean` - Check if currently playing
+
+## Playback Options
+
+### Immediate Playback (`immediate: true`)
+
+Clear existing queue and play audio immediately:
+
+```typescript
+// Stops current playback, clears queue, and plays new audio
+await client.speak('Urgent notification', {
+  immediate: true,
+  waitForEnd: true
+});
+```
+
+### Synchronous Playback (`waitForEnd: true`)
+
+Wait for playback to complete before continuing:
+
+```typescript
+// Step-by-step audio guide
+await client.speak('Step 1: Open the file', { waitForEnd: true });
+await client.speak('Step 2: Click the button', { waitForEnd: true });
+```
+
+### Queue-based Playback (`immediate: false`)
+
+Add to queue without auto-starting:
+
+```typescript
+client.speak('First message', { immediate: false });
+client.speak('Second message', { immediate: false });
+client.startPlayback();  // Start playing queue
+```
+
+## Streaming Playback
+
+When `ffplay` is available, the library can play audio directly from memory without creating temporary files:
+
+- Faster first audio playback (no disk I/O)
+- Reduced disk usage
+- Can be disabled via environment variable: `VOICEVOX_STREAMING_PLAYBACK=false`
 
 ## Audio Requirements
 
@@ -75,6 +226,19 @@ The package uses platform-native audio tools for playback:
   - `play` (SoX)
   - `ffplay` (FFmpeg)
 
+For streaming playback (optional):
+- Install `ffmpeg` which includes `ffplay`
+
+## Environment Variables
+
+- `VOICEVOX_URL`: VOICEVOX engine URL (default: `http://localhost:50021`)
+- `VOICEVOX_DEFAULT_SPEAKER`: Default speaker ID (default: `1`)
+- `VOICEVOX_DEFAULT_SPEED_SCALE`: Default playback speed (default: `1.0`)
+- `VOICEVOX_DEFAULT_IMMEDIATE`: Start playback immediately (default: `true`)
+- `VOICEVOX_DEFAULT_WAIT_FOR_START`: Wait for playback start (default: `false`)
+- `VOICEVOX_DEFAULT_WAIT_FOR_END`: Wait for playback end (default: `false`)
+- `VOICEVOX_STREAMING_PLAYBACK`: Enable streaming playback (default: `true`)
+
 ## Development
 
 This package is part of the MCP VOICEVOX project. For development:
@@ -89,10 +253,10 @@ npm run build
 # Run tests (includes audio playback mocking)
 npm test
 
-# Type checking
+# Type checking and linting
 npm run lint
 ```
 
 ## License
 
-MIT License
+MIT License

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import { AudioQuery, Speaker } from "./types";
+import type { AudioQuery, Speaker } from './types';
 export declare class VoicevoxApi {
     private readonly baseUrl;
     constructor(baseUrl: string);
@@ -23,9 +23,14 @@ export declare class VoicevoxApi {
      */
     getSpeakerInfo(uuid: string): Promise<Speaker>;
     /**
-     * APIリクエストを実行
-     * @private
+     * VOICEVOX Engine の接続状態をチェック
+     * @returns 接続情報（connected, version, url）
      */
+    checkHealth(): Promise<{
+        connected: boolean;
+        version?: string;
+        url: string;
+    }>;
     private makeRequest;
     /**
      * URLの正規化

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAG9C,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,MAAM;IAI3B;;OAEG;IACU,aAAa,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,UAAU,CAAC;IAetB;;OAEG;IACU,UAAU,CACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,MAAU,GAClB,OAAO,CAAC,WAAW,CAAC;IAiBvB;;OAEG;IACU,uBAAuB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,CAAC;IAuBtB;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAkB9C;;OAEG;IACU,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa3D;;;OAGG;YACW,WAAW;IAuCzB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAGrB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAElD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAEhC,YAAY,OAAO,EAAE,MAAM,EAE1B;IAED;;OAEG;IACU,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAWzE;IAED;;OAEG;IACU,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAe5E;IAED;;OAEG;IACU,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB9G;IAED;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAW7C;IAED;;OAEG;IACU,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAW1D;IAED;;;OAGG;IACU,WAAW,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAezF;YAMa,WAAW;IAoCzB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAGrB"}

package/dist/api.js

@@ -7,6 +7,7 @@ exports.VoicevoxApi = void 0;
 const axios_1 = __importDefault(require("axios"));
 const error_1 = require("./error");
 class VoicevoxApi {
+    baseUrl;
     constructor(baseUrl) {
         this.baseUrl = this.normalizeUrl(baseUrl);
     }
@@ -16,13 +17,13 @@ class VoicevoxApi {
     async generateQuery(text, speaker = 1) {
         try {
             const endpoint = `/audio_query?text=${encodeURIComponent(text)}&speaker=${encodeURIComponent(speaker.toString())}`;
-            const query = await this.makeRequest("post", endpoint, null, {
-                "Content-Type": "application/json",
+            const query = await this.makeRequest('post', endpoint, null, {
+                'Content-Type': 'application/json',
             });
             return query;
         }
         catch (error) {
-            throw (0, error_1.handleError)("音声クエリ生成中にエラーが発生しました", error);
+            throw (0, error_1.handleError)('音声クエリ生成中にエラーが発生しました', error);
         }
     }
     /**
@@ -30,13 +31,13 @@ class VoicevoxApi {
      */
     async synthesize(query, speaker = 1) {
         try {
-            return await this.makeRequest("post", `/synthesis?speaker=${encodeURIComponent(speaker.toString())}`, query, {
-                "Content-Type": "application/json",
-                Accept: "audio/wav",
-            }, "arraybuffer");
+            return await this.makeRequest('post', `/synthesis?speaker=${encodeURIComponent(speaker.toString())}`, query, {
+                'Content-Type': 'application/json',
+                Accept: 'audio/wav',
+            }, 'arraybuffer');
         }
         catch (error) {
-            throw (0, error_1.handleError)("音声合成中にエラーが発生しました", error);
+            throw (0, error_1.handleError)('音声合成中にエラーが発生しました', error);
         }
     }
     /**
@@ -48,13 +49,13 @@ class VoicevoxApi {
             if (coreVersion) {
                 endpoint += `&core_version=${encodeURIComponent(coreVersion)}`;
             }
-            const query = await this.makeRequest("post", endpoint, null, {
-                "Content-Type": "application/json",
+            const query = await this.makeRequest('post', endpoint, null, {
+                'Content-Type': 'application/json',
             });
             return query;
         }
         catch (error) {
-            throw (0, error_1.handleError)("プリセットを使用した音声クエリ生成中にエラーが発生しました", error);
+            throw (0, error_1.handleError)('プリセットを使用した音声クエリ生成中にエラーが発生しました', error);
         }
     }
     /**
@@ -62,14 +63,14 @@ class VoicevoxApi {
      */
     async getSpeakers() {
         try {
-            const endpoint = "/speakers";
-            const response = await this.makeRequest("get", endpoint, null, {
-                "Content-Type": "application/json",
+            const endpoint = '/speakers';
+            const response = await this.makeRequest('get', endpoint, null, {
+                'Content-Type': 'application/json',
             });
             return response;
         }
         catch (error) {
-            throw (0, error_1.handleError)("スピーカー一覧取得中にエラーが発生しました", error);
+            throw (0, error_1.handleError)('スピーカー一覧取得中にエラーが発生しました', error);
         }
     }
     /**
@@ -78,20 +79,41 @@ class VoicevoxApi {
     async getSpeakerInfo(uuid) {
         try {
             const endpoint = `/speaker_info?speaker_uuid=${encodeURIComponent(uuid)}`;
-            const response = await this.makeRequest("get", endpoint, null, {
-                "Content-Type": "application/json",
+            const response = await this.makeRequest('get', endpoint, null, {
+                'Content-Type': 'application/json',
             });
             return response;
         }
         catch (error) {
-            throw (0, error_1.handleError)("スピーカー情報取得中にエラーが発生しました", error);
+            throw (0, error_1.handleError)('スピーカー情報取得中にエラーが発生しました', error);
+        }
+    }
+    /**
+     * VOICEVOX Engine の接続状態をチェック
+     * @returns 接続情報（connected, version, url）
+     */
+    async checkHealth() {
+        try {
+            // /version エンドポイントを使用（軽量）
+            const version = await this.makeRequest('get', '/version');
+            return {
+                connected: true,
+                version,
+                url: this.baseUrl,
+            };
+        }
+        catch {
+            return {
+                connected: false,
+                url: this.baseUrl,
+            };
         }
     }
     /**
      * APIリクエストを実行
      * @private
      */
-    async makeRequest(method, endpoint, data = null, headers = {}, responseType = "json") {
+    async makeRequest(method, endpoint, data = null, headers = {}, responseType = 'json') {
         try {
             const url = `${this.baseUrl}${endpoint}`;
             const config = {
@@ -120,7 +142,7 @@ class VoicevoxApi {
      * @private
      */
     normalizeUrl(url) {
-        return url.endsWith("/") ? url.slice(0, -1) : url;
+        return url.endsWith('/') ? url.slice(0, -1) : url;
     }
 }
 exports.VoicevoxApi = VoicevoxApi;

package/dist/api.js.map

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

package/dist/client.d.ts

@@ -1,67 +1,33 @@
-import { AudioQuery, SpeechSegment, VoicevoxConfig, PlaybackOptions } from "./types";
+import { QueueService } from './queue/queue-service';
+import type { AudioQuery, PlaybackOptions, SpeakResult, SpeechSegment, VoicevoxConfig } from './types';
+/**
+ * 話者オプション（統一API用）
+ */
+export interface SpeakOptions extends PlaybackOptions {
+    /** 話者ID */
+    speaker?: number;
+    /** 再生速度 */
+    speedScale?: number;
+}
 export declare class VoicevoxClient {
-    private readonly player;
+    private readonly queueService;
     private readonly api;
     private readonly defaultSpeaker;
     private readonly defaultSpeedScale;
+    private readonly defaultVolumeScale?;
+    private readonly defaultPitchScale?;
+    private readonly defaultPrePhonemeLength?;
+    private readonly defaultPostPhonemeLength?;
     private readonly defaultPlaybackOptions;
     private readonly maxSegmentLength;
     constructor(config: VoicevoxConfig);
     /**
-     * PlaybackOptionsをマージし、undefinedの値を除外します
-     */
-    private mergePlaybackOptions;
-    /**
-     * テキストを音声に変換して再生します
-     * @param text 変換するテキスト
-     * @param speaker 話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    speak(text: string, speaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * テキスト配列を音声に変換して再生します
-     * @param texts 変換するテキストの配列
-     * @param speaker 話者ID（オプション、全体のデフォルト）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    speak(texts: string[], speaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * テキストと話者のペア配列を音声に変換して再生します
-     * @param segments テキストと話者のペア配列
-     * @param defaultSpeaker デフォルト話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    speak(segments: SpeechSegment[], defaultSpeaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * テキストを音声に変換して再生します（オプション付き）
-     * @param text 変換するテキスト
-     * @param speaker 話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @param options 再生オプション
-     * @returns 処理結果のメッセージ
+     * テキストを音声に変換して再生します（統一API）
+     * @param input テキスト、テキスト配列、またはセグメント配列
+     * @param options 再生オプション（speaker, speedScale, immediate, waitForStart, waitForEnd）
+     * @returns 処理結果
      */
-    speak(text: string, speaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
-    /**
-     * テキスト配列を音声に変換して再生します（オプション付き）
-     * @param texts 変換するテキストの配列
-     * @param speaker 話者ID（オプション、全体のデフォルト）
-     * @param speedScale 再生速度（オプション）
-     * @param options 再生オプション
-     * @returns 処理結果のメッセージ
-     */
-    speak(texts: string[], speaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
-    /**
-     * テキストと話者のペア配列を音声に変換して再生します（オプション付き）
-     * @param segments テキストと話者のペア配列
-     * @param defaultSpeaker デフォルト話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @param options 再生オプション
-     * @returns 処理結果のメッセージ
-     */
-    speak(segments: SpeechSegment[], defaultSpeaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
+    speak(input: string | string[] | SpeechSegment[], options?: SpeakOptions): Promise<SpeakResult>;
     /**
      * 入力を統一フォーマット（SpeechSegment[]）に変換
      * @private
@@ -85,73 +51,12 @@ export declare class VoicevoxClient {
      */
     generateAudioFile(textOrQuery: string | AudioQuery, outputPath?: string, speaker?: number, speedScale?: number): Promise<string>;
     /**
-     * テキストを音声ファイル生成キューに追加します
-     * @param text テキスト
-     * @param speaker 話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(text: string, speaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * テキスト配列を音声ファイル生成キューに追加します
-     * @param texts テキスト配列
-     * @param speaker 話者ID（オプション、全体のデフォルト）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(texts: string[], speaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * テキストと話者のペア配列を音声ファイル生成キューに追加します
-     * @param segments テキストと話者のペア配列
-     * @param defaultSpeaker デフォルト話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(segments: SpeechSegment[], defaultSpeaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * 音声合成用クエリを音声ファイル生成キューに追加します
-     * @param query 音声合成用クエリ
-     * @param speaker 話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(query: AudioQuery, speaker?: number, speedScale?: number): Promise<string>;
-    /**
-     * テキストを音声ファイル生成キューに追加します（オプション付き）
-     * @param text テキスト
-     * @param speaker 話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @param options 再生オプション
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(text: string, speaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
-    /**
-     * テキスト配列を音声ファイル生成キューに追加します（オプション付き）
-     * @param texts テキスト配列
-     * @param speaker 話者ID（オプション、全体のデフォルト）
-     * @param speedScale 再生速度（オプション）
+     * テキストを音声ファイル生成キューに追加します（統一API）
+     * @param input テキスト、テキスト配列、セグメント配列、またはAudioQuery
      * @param options 再生オプション
-     * @returns 処理結果のメッセージ
+     * @returns 処理結果
      */
-    enqueueAudioGeneration(texts: string[], speaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
-    /**
-     * テキストと話者のペア配列を音声ファイル生成キューに追加します（オプション付き）
-     * @param segments テキストと話者のペア配列
-     * @param defaultSpeaker デフォルト話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @param options 再生オプション
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(segments: SpeechSegment[], defaultSpeaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
-    /**
-     * 音声合成用クエリを音声ファイル生成キューに追加します（オプション付き）
-     * @param query 音声合成用クエリ
-     * @param speaker 話者ID（オプション）
-     * @param speedScale 再生速度（オプション）
-     * @param options 再生オプション
-     * @returns 処理結果のメッセージ
-     */
-    enqueueAudioGeneration(query: AudioQuery, speaker?: number, speedScale?: number, options?: PlaybackOptions): Promise<string>;
+    enqueueAudioGeneration(input: string | string[] | SpeechSegment[] | AudioQuery, options?: SpeakOptions): Promise<SpeakResult>;
     /**
      * 話者IDを取得（指定がない場合はデフォルト値を使用）
      * @private
@@ -162,6 +67,16 @@ export declare class VoicevoxClient {
      * @private
      */
     private getSpeedScale;
+    /**
+     * SpeakResultを生成
+     * @private
+     */
+    private createSpeakResult;
+    /**
+     * テキストプレビューを生成
+     * @private
+     */
+    private createTextPreview;
     private validateConfig;
     /**
      * キューをクリア
@@ -178,5 +93,43 @@ export declare class VoicevoxClient {
      * @returns スピーカー情報
      */
     getSpeakerInfo(uuid: string): Promise<import("./types").Speaker>;
+    /**
+     * VOICEVOX Engine の接続状態をチェック
+     * @returns 接続情報（connected, version, url）
+     */
+    checkHealth(): Promise<{
+        connected: boolean;
+        version?: string;
+        url: string;
+    }>;
+    /**
+     * QueueServiceインスタンスを取得
+     * 高度な操作のため公開
+     */
+    getQueueService(): QueueService;
+    /**
+     * 再生を開始
+     */
+    startPlayback(): void;
+    /**
+     * 再生を一時停止
+     */
+    pausePlayback(): void;
+    /**
+     * 再生を再開
+     */
+    resumePlayback(): void;
+    /**
+     * キュー内のアイテム数を取得
+     */
+    getQueueLength(): number;
+    /**
+     * キューが空かどうかを確認
+     */
+    isQueueEmpty(): boolean;
+    /**
+     * キューが再生中かどうかを確認
+     */
+    isPlaying(): boolean;
 }
 //# sourceMappingURL=client.d.ts.map