音声合成

Using @capgo/capacitor-speech-synthesis

音声合成プラグイン

インストール

bun add @capgo/capacitor-speech-synthesis
bunx cap sync

このプラグインが公開するもの

• speak - 指定されたオプションで与えられたテキストを話します。発話は音声キューに追加されます。
• synthesizeToFile - Android/iOS でのみ、テキストから音声を合成します。音声ファイルの保存先のパスを返します。
• cancel - キュー内のすべての発話をキャンセルし、現在の音声を停止します。
• pause - 即時停止話し言葉。

例の使用

speak

指定されたオプションで与えられたテキストを話し言葉にします。話し言葉のキューに発言を追加します。

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

const result = await SpeechSynthesis.speak({
  text: 'Hello, world!',
  language: 'en-US',
  rate: 1.0,
  pitch: 1.0,
  volume: 1.0,
  queueStrategy: 'Add'
});
console.log('Utterance ID:', result.utteranceId);

synthesizeToFile

Android/iOSのみで話し言葉を音声ファイルに合成します。音声ファイルが保存されたファイルパスを返します。

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

const result = await SpeechSynthesis.synthesizeToFile({
  text: 'Hello, world!',
  language: 'en-US'
});
console.log('Audio file saved at:', result.filePath);

cancel

キュー内のすべての発言をキャンセルし、現在の話し言葉を停止します。

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

await SpeechSynthesis.cancel();

pause

即時停止話し言葉。

import { SpeechSynthesis } from '@capgo/capacitor-speech-synthesis';

await SpeechSynthesis.pause();

フルリファレンス

• GitHub: https://github.com/Cap-go/capacitor-speech-synthesis/
• ドキュメント: /docs/plugins/speech-synthesis/