Bagian ini menjelaskan autentikasi, konfigurasi media, pembuatan koneksi, dan penanganan peristiwa tugas untuk mengakses Qwen-Audio-TTS melalui AOQ.
Saat mengakses Qwen-Audio-TTS melalui AOQ, klien mengirim teks dan peristiwa tugas melalui track Data serta menerima ucapan yang disintesis melalui track Audio.
Atur variabel lingkungan
Jika menggunakan Token Plan,
Gunakan
Tunggu
Serialisasikan JSON berikut ke UTF-8, tulis ke
Baca
SDK menerima dan memutar ucapan dari track Audio.
Setelah semua teks dikirim, kirim
Saat koneksi tidak lagi diperlukan, tunggu audio yang telah diterima selesai diputar, lalu panggil
Prasyarat
- Pilih model yang mendukung AOQ. Dukungan protokol untuk
qwen-audio-3.1-tts-plus,qwen-audio-3.1-tts-flash,qwen-audio-3.0-tts-plus, danqwen-audio-3.0-tts-flashdijelaskan dalam Cakupan dukungan model dan protokol. - Konfigurasikan dan gunakan API Key di AppServer bisnis dengan region dan ruang kerja yang sesuai.
- Impor AOQ SDK untuk platform Anda dari Unduhan SDK. Contoh berikut menggunakan Android Java dan transmisi Opus, jadi impor juga plugin Opus. Sintesis teks ke ucapan tidak memerlukan izin mikrofon atau kamera.
1. Memperoleh kredensial koneksi
Untuk mengambil token lebih awal atau memahami seluruh alur otentikasi, lihat detail otentikasi koneksi.
DASHSCOPE_API_KEY pada AppServer dan ganti {endpoint} dengan domain akses region dan ruang kerja yang dipilih. Qwen-Audio-TTS menggunakan jalur koneksi Inference. Contoh berikut menggunakan qwen-audio-3.0-tts-flash.
WorkspaceId pada domain akses ditetapkan ke token-plan. clientIp dalam isi permintaan bersifat opsional. Isi dengan alamat IP publik klien yang sebenarnya agar gateway dapat memilih titik akses Relay. Jika kosong, gateway menggunakan IP sumber permintaan.
API Key hanya disimpan di AppServer. AppServer mengembalikan parameter koneksi pada tabel berikut ke klien. sidExpiresInSecs dalam respons menunjukkan masa berlaku sesi dalam detik.
| Bidang respons gateway | Bidang AoqConnectConfig |
|---|---|
aoqTokenForClient | token |
sid | sid |
clientRelayCertFingerprint | certFingerprint |
clientRelayEndpoints | relayEndpoints, konversi endpoint, port, dan route_index per item |
extraInfo.workspaceIdHash | workspaceIdHash |
2. Menginisialisasi SDK dan membuat koneksi
Gunakan AoqCreateConfig untuk mengatur direktori kerja SDK, panggil AoqClientEngine.createEngine untuk membuat engine, lalu daftarkan callback. Tangani status koneksi dalam onConnectionStatusChange, parse peristiwa model dalam onDataMsg, dan tangani error SDK dalam onError. SDK Android menyediakan dokumentasi antarmuka lengkap untuk inisialisasi engine dan bidang koneksi.
Setelah mengisi kredensial dari AppServer ke connectConfig, publikasikan track Data dan berlangganan track Audio serta Data. Contoh ini mengonfigurasi dekode Opus mono 24 kHz dan memulai pemutar. Format output model ditentukan oleh peristiwa tugas, sedangkan konfigurasi dekode SDK digunakan untuk transmisi track media.
onConnectionStatusChange mengembalikan AoqConnectionStatusConnected sebelum memulai tugas. Jika terjadi masalah koneksi, hapus status tugas lokal. Membuat ulang koneksi memerlukan kredensial koneksi baru.
3. Memulai tugas sintesis dan memproses peristiwa
Serialisasikan JSON berikut ke UTF-8, tulis ke AoqDataMsg.data, lalu kirim melalui track Data menggunakan sendDataMsg. Setiap tugas menghasilkan task_id baru dan semua peristiwa dalam putaran ini menggunakan nilai yang sama. Gunakan suara yang sesuai dengan model pilihan.
header.event dalam onDataMsg. Setelah menerima task-started, kirim satu atau beberapa continue-task untuk mengirim teks.
result-generated adalah peristiwa tugas pada track Data, sedangkan audio dikirim melalui track Audio. Setelah menerima task-failed, baca header.error_code dan header.error_message, lalu akhiri tugas saat ini.
Untuk detail parameter tugas dan bidang peristiwa, lihat Peristiwa klien dan Peristiwa server.
4. Mengakhiri tugas dan melepas sumber daya
Setelah semua teks dikirim, kirim finish-task. Pertahankan koneksi dan tunggu server menyintesis teks yang tersisa serta mengembalikan task-finished.
stopAudioPlayer, disconnect, dan AoqClientEngine.destroy secara berurutan untuk melepas sumber daya.