跳转到主要内容
Flutter SDK

Qwen-Audio-TTS / CosyVoice Flutter SDK

使用 Flutter SDK 接入 Qwen-Audio-TTS 和 CosyVoice 双向流式语音合成,包含 Dart 调用流程、请求参数和事件。

Qwen-Audio-TTS 和 CosyVoice 共用双向流式接口。应用可以分次发送文本,并在合成期间接收音频。

前提条件

移动端应用请勿硬编码长期 API Key。调用支持临时 API Key 的模型时,由应用服务端生成临时 API Key并下发给客户端。

安装 SDK

在 SDK 下载页面获取移动端语音 SDK 整合包。解压后将 Flutter SDK 目录复制到项目的 packages/aliyun_neonui,并在 pubspec.yaml 中添加本地依赖。
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
运行 flutter pub get,然后在 Dart 文件中导入 SDK。
import 'package:aliyun_neonui/neonui.dart';

快速开始

  1. 连接目标设备,在解压后的 SDK 目录中运行示例。
cd example
flutter pub get
flutter run
  1. 打开示例应用,选择服务地址并填写 API Key。
  2. 打开 Qwen-Audio-TTS 或 CosyVoice 双向流式语音合成示例并运行。
完整示例见整合包中的 example/lib/pages/dashscope/dash_cosy_voice_stream_tts_page.dart。 包内示例包含以下模型:
  • qwen-audio-3.1-tts-flash
  • qwen-audio-3.1-tts-plus
  • qwen-audio-3.0-tts-flash
  • qwen-audio-3.0-tts-plus
  • cosyvoice-v3-flash
  • cosyvoice-v3-plus

调用步骤

通过 NativeNui() 获取实例后调用以下方法。
  1. 先订阅 streamTtsEventStream 和 streamTtsAudioStream,再启动合成。下文的 ticketJson 和 paramsJson 分别对应「请求参数」中的连接参数和任务参数。
await nui.streamTtsStart(ticket: ticketJson, params: paramsJson);
await nui.streamTtsSend('你好,');
await nui.streamTtsSend('欢迎使用语音合成。');
  1. 开始合成后分次发送文本,通过音频流接收并播放返回音频。
  2. 用 streamTtsStop 结束文本输入,收到合成完成事件后调用 streamTtsRelease。

请求参数

以下示例使用包内示例的一个模型。需要调整其他字段时,可参考整合包中的 example/lib/dashscope_params.dart。更多参数说明见 Android SDK、iOS SDK、HarmonyOS SDK。

连接参数

将连接参数作为 ticket 传入。
{
  "apikey": "YOUR_API_KEY",
  "device_id": "YOUR_DEVICE_ID",
  "url": "wss://maas.qianwenaiapi.com/api-ws/v1/inference"
}

任务参数

示例中的 JSON 作为字符串传入 Dart 方法。
{
  "model": "qwen-audio-3.1-tts-flash",
  "voice": "longanhuan_v3.1",
  "format": "pcm",
  "enable_audio_decoder": false,
  "sample_rate": 24000,
  "volume": 50,
  "rate": 1.0,
  "pitch": 1.0
}
model 和 voice 必须匹配。format、sample_rate 定义音频输出格式和采样率。示例选择 MP3 或 Opus 时会启用 enable_audio_decoder。

接口参考

方法

返回 Future<int> 的方法中,结果码 0 表示成功。
方法签名用途
Future<int> streamTtsStart({required String ticket, required String params, String sessionId = "", int logLevel = 0, bool saveLog = false})创建流式合成会话,传入票据 ticket 和参数 params 两段 JSON 字符串。
Future<int> streamTtsSend(String text)继续发送一段文本。
Future<int> streamTtsStop({bool flagAsync = true})结束文本输入。flagAsync 默认为 true,使用异步停止。
Future<int> streamTtsAsyncPlay({required String ticket, required String params, required String text, String sessionId = "", int logLevel = 0, bool saveLog = false})一次提交完整文本,异步接收合成结果。
Future<int> streamTtsCancel()取消当前会话或合成。
Future<int> streamTtsRelease()释放 SDK 资源。

事件与音频流

事件从 streamTtsEventStream 读取。收到 Dart Map 时,以 event 识别事件名,任务类事件的 resultCode 可用于判断错误。 音频流 streamTtsAudioStream 返回音频分片。应用负责播放音频。
事件用途
STREAM_INPUT_TTS_EVENT_SYNTHESIS_STARTED合成或回复音频开始
STREAM_INPUT_TTS_EVENT_SENTENCE_SYNTHESIS句级合成事件
STREAM_INPUT_TTS_EVENT_SYNTHESIS_COMPLETE任务或当前音频输出完成
STREAM_INPUT_TTS_EVENT_TASK_FAILED任务失败
Qwen-Audio-TTS / CosyVoice Flutter SDK - 千问AI平台