Skip to main content

Qwen-Audio-TTS / CosyVoice Flutter SDK

Panduan integrasi Qwen-Audio-TTS / CosyVoice dengan Flutter SDK, mencakup urutan panggilan Dart, parameter permintaan, dan peristiwa.

Qwen-Audio-TTS dan CosyVoice menggunakan API streaming dua arah yang sama. Aplikasi dapat mengirim teks secara bertahap sambil menerima audio hasil sintesis.

Prasyarat

  • Siapkan lingkungan pengembangan Flutter untuk platform target. Aplikasi contoh memerlukan Dart versi 3.4 atau yang lebih baru, di bawah 4.0.
  • Dapatkan kunci API. Pilih endpoint layanan di region yang sama dengan kunci API. Jika menggunakan domain khusus ruang kerja, dapatkan juga ID ruang kerja.
Jangan tanamkan kunci API jangka panjang di kode aplikasi seluler. Untuk model yang mendukung kunci API sementara, gunakan server aplikasi untuk membuat kunci API sementara dan mengirimkannya ke klien.

Instal SDK

Buka Pemilihan dan pengunduhan SDK ucapan seluler, pilih tab Flutter, lalu unduh dan ekstrak paket. Salin direktori SDK yang telah diekstrak ke packages/aliyun_neonui di proyek Flutter, lalu tambahkan dependensi lokal ke pubspec.yaml.
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
Jalankan flutter pub get, lalu impor SDK di file Dart.
import 'package:aliyun_neonui/neonui.dart';

Mulai cepat

Jalankan aplikasi contoh

  1. Hubungkan perangkat target. Jalankan perintah berikut dari direktori SDK yang telah diekstrak.
    cd example
    flutter pub get
    flutter run
    
  2. Pada layar utama aplikasi contoh, buka 百炼(DashScope). Pilih endpoint layanan dan masukkan API Key. Jika menggunakan domain khusus ruang kerja, masukkan juga WorkspaceId.
  3. Buka Qwen-Audio-TTS/CosyVoice 双向流式语音合成 dan jalankan contoh.
Contoh lengkap ada di example/lib/pages/dashscope/dash_cosy_voice_stream_tts_page.dart dalam paket SDK.

Model dalam contoh yang disertakan

  • 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

Urutan pemanggilan

Panggil metode berikut pada instance yang diperoleh dari NativeNui().
  1. Berlangganan streamTtsEventStream dan streamTtsAudioStream sebelum memanggil metode berikut.
  2. Gunakan JSON koneksi dan JSON tugas di bawah sebagai ticketJson dan paramsJson.
    await nui.streamTtsStart(ticket: ticketJson, params: paramsJson);
    await nui.streamTtsSend('你好,');
    await nui.streamTtsSend('欢迎使用语音合成。');
    
    Setelah memulai sintesis, kirim teks secara bertahap dan putar audio yang diterima dari stream.
  3. Akhiri input teks dengan streamTtsStop. Setelah menerima peristiwa sintesis selesai, panggil streamTtsRelease.

Parameter permintaan

Contoh ini menggunakan salah satu model dalam paket. Untuk pengaturan tambahan, lihat example/lib/dashscope_params.dart di dalam paket. Untuk penjelasan parameter lainnya, lihat Android SDK, iOS SDK, HarmonyOS SDK. Ganti YOUR_WS_HOST dengan host WebSocket untuk region Anda, YOUR_DEVICE_ID dengan ID perangkat, dan YOUR_API_KEY dengan kunci API untuk region tersebut.

Parameter koneksi

Teruskan JSON koneksi sebagai ticket.
{
  "apikey": "YOUR_API_KEY",
  "device_id": "YOUR_DEVICE_ID",
  "url": "wss://YOUR_WS_HOST/api-ws/v1/inference"
}

Parameter tugas

Teruskan JSON contoh sebagai string ke metode 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
}
Gunakan voice yang kompatibel dengan model. format dan sample_rate mengatur format keluaran dan laju sampel. Contoh mengaktifkan enable_audio_decoder untuk MP3 atau Opus.

Referensi API

Metode

Untuk metode yang mengembalikan Future<int>, kode 0 menandakan keberhasilan.
Tanda tangan metodeKegunaan
Future<int> streamTtsStart({required String ticket, required String params, String sessionId = "", int logLevel = 0, bool saveLog = false})Buat sesi sintesis streaming. Teruskan ticket dan params sebagai dua string JSON.
Future<int> streamTtsSend(String text)Kirim potongan teks berikutnya.
Future<int> streamTtsStop({bool flagAsync = true})Akhiri masukan teks. Nilai default flagAsync adalah true untuk penghentian asinkron.
Future<int> streamTtsAsyncPlay({required String ticket, required String params, required String text, String sessionId = "", int logLevel = 0, bool saveLog = false})Kirim teks lengkap sekaligus dan terima hasil sintesis secara asinkron.
Future<int> streamTtsCancel()Batalkan sesi atau tugas sintesis saat ini.
Future<int> streamTtsRelease()Lepaskan sumber daya SDK.

Peristiwa dan stream audio

Baca peristiwa dari streamTtsEventStream. Jika peristiwa dikirim sebagai map Dart, gunakan event untuk membaca nama peristiwa dan resultCode untuk memeriksa kegagalan tugas. Stream streamTtsAudioStream mengirim potongan audio untuk diputar oleh aplikasi.
PeristiwaKegunaan
STREAM_INPUT_TTS_EVENT_SYNTHESIS_STARTEDSintesis atau keluaran suara dimulai
STREAM_INPUT_TTS_EVENT_SENTENCE_SYNTHESISPeristiwa sintesis tingkat kalimat
STREAM_INPUT_TTS_EVENT_SYNTHESIS_COMPLETETugas atau keluaran audio saat ini selesai
STREAM_INPUT_TTS_EVENT_TASK_FAILEDTugas gagal