Panduan integrasi Sambert dengan Flutter SDK, mencakup urutan panggilan Dart, parameter permintaan, dan peristiwa.
Sambert menggunakan streaming satu arah. Aplikasi mengirim semua teks sekaligus dan menerima audio hasil sintesis secara bertahap.
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 contoh sebagai string ke metode Dart.
Atur setiap parameter tugas dengan
Untuk Sambert,
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 Sambert 单向流式语音合成 dan jalankan contoh.
example/lib/pages/dashscope/dash_sambert_tts_page.dart dalam paket SDK.
Model dalam contoh yang disertakan
sambert-zhinan-v1
Urutan pemanggilan
Panggil metode berikut pada instance yang diperoleh dari NativeNui().
-
Berlangganan
ttsEventStreamdanttsAudioStreamsebelum memanggil metode berikut. -
Gunakan JSON koneksi di bawah sebagai
initJson. Teruskan parameter tugas sebagai pasangan kunci dan nilai kettsSetParam.Setelah inisialisasi, atur parameter tugas satu per satu. Kirim teks lengkap denganttsStartdan baca audio yang diterima dari stream. -
TTS_EVENT_ENDmenandakan SDK telah mengembalikan audio. PanggilttsReleasesetelah selesai.
Parameter permintaan
Contoh ini menggunakan salah satu model dalam paket. Untuk pengaturan tambahan, lihat example/lib/dashscope_params.dart di dalam paket.
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 contoh sebagai string ke metode Dart.
Parameter tugas
Atur setiap parameter tugas dengan ttsSetParam(key, value). Teruskan nilai numerik sebagai string sesuai contoh.
model memilih ID model yang terkait dengan suara. Contoh ini menggunakan suara 48 kHz dari paket. Putar audio pada laju sampel yang sama.
Referensi API
Metode
Untuk metode yang mengembalikan Future<int>, kode 0 menandakan keberhasilan.
| Tanda tangan metode | Kegunaan |
|---|---|
Future<int> ttsInitialize({required String params, int logLevel = 0, bool saveLog = false}) | Inisialisasi SDK dengan parameter koneksi sebagai string JSON. |
Future<int> ttsSetParam(String key, String value) | Atur satu parameter tugas bertipe string. |
Future<int> ttsStart({required String priority, required String taskId, required String text}) | Kirim teks lengkap. Contoh menggunakan priority: '1' dan taskId: ''. |
Future<int> ttsPause() | Jeda sintesis. |
Future<int> ttsResume() | Lanjutkan sintesis. |
Future<int> ttsCancel(String taskId) | Batalkan sintesis berdasarkan ID tugas. |
Future<String?> ttsGetParam(String key) | Baca parameter. Gunakan error_msg untuk melihat detail kesalahan. |
Future<int> ttsRelease() | Lepaskan sumber daya SDK. |
Peristiwa dan stream audio
Baca peristiwa dari ttsEventStream. Jika peristiwa dikirim sebagai map Dart, gunakan event untuk membaca nama peristiwa dan resultCode untuk memeriksa kegagalan tugas.
Stream ttsAudioStream mengirim potongan audio untuk diputar oleh aplikasi.
| Peristiwa | Kegunaan |
|---|---|
TTS_EVENT_START | Sintesis atau keluaran suara dimulai |
TTS_EVENT_END | Tugas atau keluaran audio saat ini selesai |
TTS_EVENT_CANCEL | Tugas dibatalkan |
TTS_EVENT_ERROR | Tugas gagal |