メインコンテンツにジャンプ
@capgo/capacitor-speech-synthesis メディア オープンソース

音声合成 Capacitor プラグイン

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

インストール

bun add @capgo/capacitor-speech-synthesis bunx cap sync
npm、pnpm、またはyarn
  • npm install @capgo/capacitor-speech-synthesis
  • pnpm add @capgo/capacitor-speech-synthesis
  • yarn add @capgo/capacitor-speech-synthesis

ガイド

Capacitorの音声合成を使用する方法

デバイスでテスト

Download the Capgo app, then scan the QR code.

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

@capgo/capacitor-speech-synthesisを使用

音声合成プラグイン

インストール

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

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

インポート

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

APIの概要

方法 概要
speak 指定されたオプションで与えられたテキストを話します。発話は音声キューに追加されます。
synthesizeToFile Android/iOSのみで、テキストを音声ファイルに合成します。音声ファイルの保存先のパスを返します。
cancel キュー内のすべての発話をキャンセルし、現在の発話を停止します。
pause 発話を即時停止します。
resume 一時停止した発話を再開します。
isSpeaking 現在発話中かどうかを確認します。
isAvailable このデバイスで音声合成が利用可能かどうかを確認します。
getVoices 利用可能なすべての声のリストを取得します。
getLanguages 利用可能なすべての言語のリストを取得します。
isLanguageAvailable 特定の言語が利用可能かどうかを確認します。
isVoiceAvailable 特定の声が利用可能かどうかを確認します。
initialize iOS向けの音声合成エンジンを初期化します (初回の音声要求の遅延を削減することができます)。
activateAudioSession iOS専用の特定のカテゴリでオーディオセッションを有効にします。
deactivateAudioSession iOS専用のオーディオセッションを無効にします。

例

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() フルリファレンス

__CAPGO_KEEP_0__ リポジトリ

使用@capgo/capacitor-speech-synthesisを続けてください。

使用中の@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-speech-synthesis @Capacitor/ capgo/capacitor-speech-synthesis __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-speech-synthesis @capgo/capacitor-speech-synthesis @capgo/capacitor-speech-synthesis はじめに Getting Started Capgo Plugin Directory Capgo Plugin Directory Capacitor Capgoのプラグイン Capacitor Plugins by Capgo プラグインの追加または更新 Adding or Updating Plugins

FAQ

スピーチ合成プラグインのFAQ

Capacitor スピーチ合成プラグインを Capacitor アプリにインストールする方法は?

Run "bun add @capgo/capacitor-speech-synthesis" (または "npm install @capgo/capacitor-speech-synthesis"), するとiOSとAndroidのプロジェクトがネイティブcodeを取得します。次に、"bunx cap sync"を実行して、iOSとAndroidのプロジェクトがネイティブcodeを取得します。次に、@capgo/capacitor-speech-synthesisをインポートして、Capgoアプリのcodeで使用します。

Capacitor Speech Synthesis で @capgo/capacitor が React、Vue、Angular とどのように動作するか?

はい。 Speech Synthesis は Capacitor パッケージなので、 Capacitor 内で動作する任意の Web フレームワークと一緒に使用できます。 例えば、Ionic、React、Vue、Angular、Svelte、または単純な JavaScript などです。

Which Capacitor version does @capgo/capacitor-speech-synthesis support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-speech-synthesisは無料でオープンソースですか?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-speech-synthesis/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Capacitor Speech Synthesis を使用している code を App Store のレビューなしでアップデートできますか?

プラグインをインストールまたはアップグレードすると、ネイティブ code が変更されるため、ストアのビルドが必要になります。 その後、 Capgo のライブアップデートで JavaScript、HTML、CSS の変更が即座に配信できます。

Ship Speech Synthesis の変更をアプリレビューの待たずに配信する

プラグインがストアビルド内に追加されると、Capgo ライブアップデートは、JavaScript、HTML、CSSの変更をユーザーに数分で反映します。

Capgoから始めます。