跳过主要内容
返回插件
@capgo/capacitor-speech-synthesis
教程
@capgo/capacitor-speech-synthesis

语音合成

从文本中合成语音,完全控制语言、声音、音调、速度和音量。

指南

语音合成教程

在设备上测试

下载Capgo应用程序,然后扫描QRcode。

语音合成插件预览二维码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/capacitor-speech-synthesis 来规划原生插件工作,连接它与 @capgo/capacitor-speech-synthesis 对于 @capgo/capacitor-speech-synthesis 的实现细节 开始使用 对于开始使用的实现细节 Capgo 插件目录 对于 Capgo 插件目录中的产品工作流程 Capacitor 由 Capgo 提供的插件 对于 Capacitor 由 Capgo 提供的插件的实现细节 添加或更新插件 对于添加或更新插件的实现细节