使用 Flutter SDK 接入 Sambert 单向流式语音合成,包含 Dart 调用流程、请求参数和事件。
Sambert 使用单向流式接口。应用一次提交完整文本,并分片接收合成音频。
在 SDK 下载页面获取移动端语音 SDK 整合包。解压后将 Flutter SDK 目录复制到项目的
运行
通过
以下示例使用包内示例的模型。需要调整其他字段时,可参考整合包中的
示例中的 JSON 作为字符串传入 Dart 方法。
通过
Sambert 用
返回
事件从
前提条件
- 配置 Flutter 开发环境。示例工程要求 Dart 3.4 及以上、低于 4.0。
- 获取与配置 API Key。
安装 SDK
在 SDK 下载页面获取移动端语音 SDK 整合包。解压后将 Flutter SDK 目录复制到项目的 packages/aliyun_neonui,并在 pubspec.yaml 中添加本地依赖。
flutter pub get,然后在 Dart 文件中导入 SDK。
快速开始
- 连接目标设备,在解压后的 SDK 目录中运行示例。
- 打开示例应用,选择服务地址并填写 API Key。
- 打开 Sambert 单向流式语音合成示例并运行。
example/lib/pages/dashscope/dash_sambert_tts_page.dart。
包内示例包含模型 sambert-zhinan-v1。
调用步骤
通过 NativeNui() 获取实例后调用以下方法。
- 先订阅
ttsEventStream和ttsAudioStream,再初始化并合成。下文的initJson对应「请求参数」中的连接参数,任务参数按键值逐项传给ttsSetParam。
- 初始化后逐个设置任务参数。调用
ttsStart发送完整文本,应用从音频流读取返回音频。 - 收到
TTS_EVENT_END后可继续处理已收到的音频。任务用完后调用ttsRelease。
请求参数
以下示例使用包内示例的模型。需要调整其他字段时,可参考整合包中的 example/lib/dashscope_params.dart。更多参数说明见 Android SDK、iOS SDK、HarmonyOS SDK。
连接参数
示例中的 JSON 作为字符串传入 Dart 方法。
任务参数
通过 ttsSetParam(key, value) 逐项设置任务参数,以下数值也以字符串传入。
model 设置音色对应的模型 ID。示例与包内 48 kHz 音色一致,应用按相同采样率播放。
接口参考
方法
返回 Future<int> 的方法中,结果码 0 表示成功。
| 方法签名 | 用途 |
|---|---|
Future<int> ttsInitialize({required String params, int logLevel = 0, bool saveLog = false}) | 初始化 SDK。params 为连接参数 JSON 字符串。 |
Future<int> ttsSetParam(String key, String value) | 逐项设置字符串参数。 |
Future<int> ttsStart({required String priority, required String taskId, required String text}) | 提交完整待合成文本,示例使用 priority: '1'、taskId: ''。 |
Future<int> ttsPause() | 暂停合成。 |
Future<int> ttsResume() | 继续合成。 |
Future<int> ttsCancel(String taskId) | 按任务 ID 取消合成。 |
Future<String?> ttsGetParam(String key) | 读取指定参数,可用 error_msg 查看错误详情。 |
Future<int> ttsRelease() | 释放 SDK 资源。 |
事件与音频流
事件从 ttsEventStream 读取。收到 Dart Map 时,以 event 识别事件名,任务类事件的 resultCode 可用于判断错误。
音频流 ttsAudioStream 返回音频分片。应用负责播放音频。
| 事件 | 用途 |
|---|---|
TTS_EVENT_START | 合成或回复音频开始 |
TTS_EVENT_END | 任务或当前音频输出完成 |
TTS_EVENT_CANCEL | 任务已取消 |
TTS_EVENT_ERROR | 任务失败 |