Tutorial ini menggunakan Android untuk menunjukkan cara mengintegrasikan SDK Klien AOQ dengan qwen3.8-livetranslate-flash-realtime guna terjemahan ucapan waktu nyata. Platform lain menggunakan alur integrasi dan penanganan kejadian model yang serupa dengan metode SDK masing-masing. Semua contoh sisi klien di bawah ini menggunakan Java.
Untuk kemampuan model, lihat Terjemahan ucapan serta audio/video realtime. Untuk peran media dan peristiwa model, lihat Akses AOQ.
Unduh SDK
Untuk SDK Klien AOQ dan plugin audio Opus, lihat Unduh SDK. Contoh transmisi audio dalam tutorial ini menggunakan Opus, sehingga Anda juga harus mengimpor plugin tersebut untuk platform Anda. Untuk wilayah yang didukung, bahasa, harga, dan batas laju, lihat Terjemahan ucapan serta audio/video waktu nyata.
Impor SDK
- Android
- iOS
- HarmonyOS
Tempatkan Jika proyek induk sudah berisi pustaka native dengan nama yang sama, periksa versi dan dependensinya sebelum mengemasnya untuk menghindari penyertaan versi berbeda dari pustaka yang sama.Nyatakan izin dalam Minta izin
AoqClientSdk-release.aar di app/libs/. Tempatkan libPluginOpus.so di app/libs/armeabi-v7a/ dan app/libs/arm64-v8a/, sesuai dengan ABI.Nyatakan dependensi dalam app/build.gradle:AndroidManifest.xml:RECORD_AUDIO secara runtime dan peroleh otorisasi pengguna. Terjemahan hanya berbasis ucapan tidak memerlukan izin kamera. Nyatakan dan minta izin CAMERA hanya ketika Anda mengaktifkan peningkatan visual.Contoh Java menggunakan impor berikut:Peroleh token melalui AppServer Anda
Jangan menyimpan kunci API Model Studio di sisi klien. AppServer Anda menggunakan kunci API untuk wilayah dan ruang kerja yang sesuai guna meminta kredensial sementara untuk setiap koneksi terjemahan. AppServer kemudian mengembalikan kredensial tersebut melalui HTTPS ke klien yang telah melewati autentikasi aplikasi Anda.
Siapkan AppServer dengan mengikuti langkah autentikasi AOQ untuk Qwen-LiveTranslate-Realtime. Terjemahan realtime menggunakan protokol Realtime. Tentukan yang berikut saat meminta kredensial:
BAILIAN_ENDPOINT ke titik akhir ruang kerja Anda: {WorkspaceId}.cn-beijing.maas.aliyuncs.com atau {WorkspaceId}.ap-southeast-1.maas.aliyuncs.com. Baca DASHSCOPE_API_KEY dari variabel lingkungan sisi server atau layanan manajemen rahasia.
clientIp dalam badan permintaan untuk penjadwalan titik akses.
Petakan bidang respons ke AoqConnectConfig di sisi klien:
| Bidang respons gateway | Bidang SDK | Deskripsi |
|---|---|---|
aoqTokenForClient | token | Token sementara untuk koneksi ini |
sid | sid | Pengidentifikasi sesi ini |
clientRelayCertFingerprint | certFingerprint | Gunakan sidik jari sertifikat persis seperti yang dikembalikan |
clientRelayEndpoints | relayEndpoints | Konversikan daftar titik akses lengkap ke struktur SDK |
extraInfo.workspaceIdHash | workspaceIdHash | Gunakan nilai yang dikembalikan. Jika tidak tersedia, ikuti persyaratan SDK |
Implementasikan terjemahan ucapan waktu nyata
Alur interaksi

Buat engine dan tetapkan callback
Panggil createEngine untuk membuat engine dan mendaftarkan callback untuk status koneksi, pesan Data, dan kesalahan. Aplikasi Anda harus mempertahankan objek engine dan listener sepanjang sesi.
AoqClientListener untuk menerima kejadian koneksi, pesan model, dan perangkat media, lalu teruskan saat membuat engine.
Mulai penangkapan dan pemutaran audio
Setelah memperoleh izin mikrofon, siapkan penangkapan dan pemutaran audio. Nonaktifkan transmisi audio sebelum memulai penangkapan untuk mencegah engine mengirimkan media secara otomatis setelah terhubung.
Memulai penangkapan tidak berarti model siap menerima audio. Minta pengguna berbicara hanya setelah menerima session.updated dan berhasil mengaktifkan transmisi. Tutorial ini tidak mengimplementasikan penyanggaan audio sebelum koneksi.
Konfigurasikan codec dan bangun koneksi
Skenario utama memerlukan track berikut:
| Arah | Track | Tujuan |
|---|---|---|
| Publikasi | Audio | Kirim ucapan ke model |
| Publikasi | Data | Kirim konfigurasi sesi dan kejadian penyelesaian |
| Berlangganan | Audio | Terima ucapan hasil terjemahan |
| Berlangganan | Data | Terima teks sumber, teks hasil terjemahan, dan kejadian status |
connect berarti panggilan diterima. Tunggu onConnectionStatusChange melaporkan koneksi berhasil sebelum mengirim konfigurasi model.
Konfigurasikan sesi terjemahan
Setelah terhubung, kirim kejadian session.update berikut melalui track Data. Konfigurasi ini menggunakan suara bawaan dan tidak mengaktifkan kloning suara:
session.update, lihat Kejadian klien terjemahan waktu nyata.
Encode JSON sebagai byte UTF-8 dan kirimkan bersama sendDataMsg.
Aktifkan transmisi media setelah menerima session.updated
Uraikan jenis kejadian dalam onDataMsg.
Cuplikan berikut mengarahkan kejadian kontrol. Untuk kejadian teks sumber dan teks hasil terjemahan, lihat Kejadian server. Setelah menerima session.finished, atur status penyelesaian aplikasi Anda dan gunakan metode pelepasan yang dijelaskan dalam bagian "Putuskan koneksi dan hancurkan engine" untuk menyelesaikan pembersihan.
Perbedaan AOQ dan WebSocket: Contoh ini mengirim dan menerima audio langsung melalui track Audio. Jangan mengirim
input_audio_buffer.append untuk mengunggah audio yang sama lagi, atau menyalin contoh WebSocket lalu memulai pemutar lain saat response.audio.delta diterima. Audio terjemahan ditangani oleh langganan audio SDK dan pemutar. Track Data membawa subtitel dan peristiwa model. Untuk penggunaan media dan track Data, lihat Akses AOQ.Selesaikan input dan tunggu terjemahan akhir
Ketika pengguna menghentikan terjemahan, ikuti urutan berikut:
- Hentikan penangkapan agar tidak ada input baru yang dikirimkan.
- Setelah menyelesaikan input, nonaktifkan audio upstream dan kirim
session.finishsekali saja. Pertahankan koneksi AOQ, langganan Data, dan pemutaran audio aktif. - Lanjutkan menerima teks sumber akhir, teks hasil terjemahan, dan ucapan hasil terjemahan. Tunggu
session.finished. - Putuskan koneksi dan lepaskan sumber daya sesuai kebijakan penyelesaian pemutaran lokal Anda.
session.finish, lihat Kejadian klien terjemahan waktu nyata. Untuk bidang dan makna session.finished, lihat Kejadian server terjemahan waktu nyata.
Putuskan koneksi dan hancurkan engine
Setelah session.finished diterima, server telah menyelesaikan pemrosesan sesi ini. Hal ini tidak berarti pembicara lokal telah selesai memutar segmen audio terakhir. Jika aplikasi Anda harus memutar semua ucapan hasil terjemahan, selesaikan pemutaran lokal sebelum menjalankan metode berikut.