メインコンテンツにジャンプ
プラグインに戻る
@capgo/capacitor-speech-synthesis
チュートリアル
@capgo/capacitor-speech-synthesis

音声合成

テキストから音声合成を行い、言語、声、ピッチ、速度、音量を完全に制御できます。

ガイド

音声合成のチュートリアル

デバイスでテスト

Download the Capgo app, then scan the QR code.

音声合成プラグインのプレビュー QR code

使用する @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();

フル リファレンス

capgo/capacitor-speech-synthesisを使用して続行

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-speech-synthesisを使用している場合 capgo/capacitor-speech-synthesisを使用してネイティブ プラグインの作業を計画する場合、@capgo/capacitor-speech-synthesisと接続します。 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-speech-synthesisを使用します。 capgo/capacitor-speech-synthesisを使用します。 Capacitor スピーチ合成用の実装詳細については @capgo/capacitor-speech-synthesis に Getting Started Capacitor スピーチ合成用の実装詳細については Getting Started に Capgo Plugin Directory for the product workflow in Capgo Plugin Directory, Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, and プラグインの追加または更新 Capacitor スピーチ合成用の実装詳細については プラグインの追加または更新 に