跳过主要内容
返回插件
@capgo/capacitor-speech-synthesis
教程
由 github.com/Cap-go

语音合成

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

指南

语音合成教程

使用 @capgo/capacitor-语音合成

语音合成插件:将文本合成语音

安装

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 平台上生成语音文件 (仅限 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 的实现细节 添加或更新插件 为添加或更新插件的实现细节