跳过主要内容
返回插件
@capgo/capacitor-语音合成
教程
@capgo/capacitor-语音合成

语音合成

通过控制语言、声音、pitch、速度和音量等方面,合成语音。

指南

语音合成教程

在设备上测试

Download the Capgo app, then scan the QR code.

语音合成插件预览二维码code

使用@capgo/capacitor-语音合成

语音合成插件,用于将文本合成语音。

安装

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/capacitor-speech-synthesis 来规划原生插件工作,连接它与 @capgo/capacitor-speech-synthesis 为 @capgo/capacitor-speech-synthesis 的实现细节 开始使用 为 Getting Started 的实现细节 Capgo 插件目录 为 Capgo 插件目录中的产品工作流程 Capacitor 由 Capgo 提供的插件 为 Capacitor 由 Capgo 提供的插件的实现细节 添加或更新插件 为添加或更新插件的实现细节