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

语音合成

使用文本合成语音,完全控制语言、声音、pitch、速率和音量。

指南

语音合成教程

使用 @capgo/capacitor-speech-synthesis

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

安装

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

此插件暴露的内容

  • speak - 使用指定选项朗读给定的文本。朗读的内容添加到语音队列中。
  • synthesizeToFile - 只在 Android 和 iOS 平台上支持。将语音合成为音频文件(仅限 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 为native插件工作做好准备,连接它 @capgo/capacitor-speech-synthesis 查看@capgo/capacitor-speech-synthesis的实现细节 开始 查看开始的实现细节 Capgo插件目录 为产品工作流程在Capgo插件目录中 Capacitor插件由Capgo 为Capacitor插件由Capgo的实现细节 添加或更新插件 为添加或更新插件的实现细节