音声合成 Capacitor プラグイン

@capgo/capacitor-speech-synthesis の使い方

テキストから音声を合成する Speech Synthesis プラグイン。

インストール

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

bunx cap sync プラグインのネイティブcodeをネイティブプロジェクトにコピーします。プラグインをアップグレードするたびに再度実行してください。

インポート

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

API の概要

例

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();

resume()

一時停止中の再生を再開します。

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

await SpeechSynthesis.resume();

isSpeaking()

現在、音声合成が再生中かどうかを確認します。

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

const { isSpeaking } = await SpeechSynthesis.isSpeaking();
console.log('Is speaking:', isSpeaking);

上記の表には14個のコアメソッドが記載されています。リスナーやバージョンヘルパー、および各メソッドの詳細な仕様については、 GitHub リポジトリ.

イベントをリッスンする

addListener ハンドルを返します。画面がアンマウントされるときに handle.remove() 画面がアンマウントされるとき、または SpeechSynthesis.removeAllListeners() すべてのリスナーを解除します。

完全なリファレンス

• GitHub リポジトリ
• ドキュメント
• API リファレンス

@capgo/capacitor-speech-synthesis の使用方法から続ける

使用している場合 @capgo/capacitor-speech-synthesis の使い方 ネイティブプラグインの作業を計画するには、次と連携してください： @capgo/capacitor-speech-synthesis @capgo/capacitor-speech-synthesis の実装詳細については、 スタートガイド スタートガイドの実装詳細については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細、および プラグインの追加または更新 「プラグインの追加または更新」の実装詳細については、