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.
Buka Pemilihan dan pengunduhan SDK ucapan seluler, pilih tab Flutter, lalu unduh dan ekstrak paket.
Salin direktori SDK yang telah diekstrak ke
Jalankan
Panggil metode berikut pada instance yang diperoleh dari
Contoh ini menggunakan salah satu model dalam paket. Untuk pengaturan tambahan, lihat
Teruskan JSON koneksi sebagai
Teruskan JSON contoh sebagai string ke metode Dart.
Gunakan
Untuk metode yang mengembalikan
Baca peristiwa dari
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.
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.
flutter pub get, lalu impor SDK di file Dart.
Mulai cepat
Jalankan aplikasi contoh
-
Hubungkan perangkat target. Jalankan perintah berikut dari direktori SDK yang telah diekstrak.
- Pada layar utama aplikasi contoh, buka 百炼(DashScope). Pilih endpoint layanan dan masukkan API Key. Jika menggunakan domain khusus ruang kerja, masukkan juga WorkspaceId.
- Buka Qwen-Audio-TTS/CosyVoice 双向流式语音合成 dan jalankan contoh.
example/lib/pages/dashscope/dash_cosy_voice_stream_tts_page.dart dalam paket SDK.
Model dalam contoh yang disertakan
qwen-audio-3.1-tts-flashqwen-audio-3.1-tts-plusqwen-audio-3.0-tts-flashqwen-audio-3.0-tts-pluscosyvoice-v3-flashcosyvoice-v3-plus
Urutan pemanggilan
Panggil metode berikut pada instance yang diperoleh dari NativeNui().
-
Berlangganan
streamTtsEventStreamdanstreamTtsAudioStreamsebelum memanggil metode berikut. -
Gunakan JSON koneksi dan JSON tugas di bawah sebagai
ticketJsondanparamsJson.Setelah memulai sintesis, kirim teks secara bertahap dan putar audio yang diterima dari stream. -
Akhiri input teks dengan
streamTtsStop. Setelah menerima peristiwa sintesis selesai, panggilstreamTtsRelease.
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.
Parameter tugas
Teruskan JSON contoh sebagai string ke metode Dart.
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 metode | Kegunaan |
|---|---|
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.
| Peristiwa | Kegunaan |
|---|---|
STREAM_INPUT_TTS_EVENT_SYNTHESIS_STARTED | Sintesis atau keluaran suara dimulai |
STREAM_INPUT_TTS_EVENT_SENTENCE_SYNTHESIS | Peristiwa sintesis tingkat kalimat |
STREAM_INPUT_TTS_EVENT_SYNTHESIS_COMPLETE | Tugas atau keluaran audio saat ini selesai |
STREAM_INPUT_TTS_EVENT_TASK_FAILED | Tugas gagal |