Bagian ini menjelaskan autentikasi, konfigurasi media, pembuatan koneksi, dan penanganan peristiwa tugas untuk mengakses Fun-ASR-Realtime melalui AOQ.
Saat mengakses Fun-ASR-Realtime melalui AOQ, klien mengunggah audio melalui track Audio, serta mengirim peristiwa tugas dan menerima hasil pengenalan melalui track Data.
Atur variabel lingkungan
Jika menggunakan Token Plan,
Gunakan
Tunggu
Serialisasikan JSON berikut ke UTF-8, tulis ke
Baca
Baca teks pengenalan dari
Setelah perekaman berakhir, hentikan penangkapan audio baru dan tunggu audio tertunda selesai dikirim. Panggil
Saat koneksi tidak lagi diperlukan, panggil
Prasyarat
- Pilih model yang mendukung AOQ. Untuk detail dukungan, lihat Cakupan dukungan model dan protokol.
- Konfigurasikan dan gunakan API Key di AppServer bisnis dengan region dan ruang kerja yang sesuai.
- Unduh dan impor AOQ SDK untuk platform Anda dari SDK. Penjelasan berikut menggunakan Android Java dan transmisi Opus sebagai contoh, jadi impor juga plugin Opus. Jika menangkap audio dengan mikrofon, minta izin perekaman di sisi klien.
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 endpoint region dan ruang kerja yang dipilih. Fun-ASR-Realtime menggunakan jalur koneksi Inference. Contoh berikut menggunakan fun-asr-realtime.
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 Audio serta Data dan berlangganan track Data. Contoh berikut mengonfigurasi enkode Opus mono 16 kHz dan perekaman bawaan, serta menonaktifkan transmisi track Audio selama pembuatan koneksi. Format input model ditentukan oleh peristiwa tugas, sedangkan konfigurasi enkode 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 pengenalan dan menangani 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.
header.event dari onDataMsg. Audio uplink hanya boleh dikirim setelah menerima task-started.
payload.output.sentence dalam result-generated dan abaikan heartbeat dengan heartbeat=true. sentence_end=false menunjukkan teks sementara, sedangkan sentence_end=true menunjukkan teks kalimat final. Perbarui teks untuk kalimat yang sama berdasarkan sentence_id. Setelah menerima task-failed, hentikan uplink putaran ini dan baca header.error_code serta header.error_message.
Untuk parameter tugas dan bidang peristiwa, lihat Peristiwa klien dan Peristiwa server.
4. Mengakhiri tugas dan melepas sumber daya
Setelah perekaman berakhir, hentikan penangkapan audio baru dan tunggu audio tertunda selesai dikirim. Panggil enableSendMediaStream untuk menutup uplink track Audio, lalu kirim finish-task melalui track Data. Pertahankan koneksi untuk menerima sisa hasil pengenalan dan menunggu task-finished.
stopAudioCapture, disconnect, dan AoqClientEngine.destroy secara berurutan untuk melepas sumber daya.