Skip to main content

Qwen-Audio-ASR / Fun-ASR Flutter SDK

Panduan integrasi Qwen-Audio-ASR / Fun-ASR dengan Flutter SDK, mencakup urutan panggilan Dart, parameter permintaan, dan peristiwa.

Pengenalan real-time mentranskripsikan ucapan. Qwen-Audio-ASR-Message, Qwen-Audio-ASR-Streaming, dan Fun-ASR menggunakan API sesi dan mikrofon yang sama. Gunakan nls_config.model untuk memilih model.

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.
Jangan tanamkan kunci API jangka panjang di kode aplikasi seluler. Untuk model yang mendukung kunci API sementara, gunakan server aplikasi untuk membuat kunci API sementara dan mengirimkannya ke klien.

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.
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
Jalankan flutter pub get, lalu impor SDK di file Dart.
import 'package:aliyun_neonui/neonui.dart';

Mulai cepat

Jalankan aplikasi contoh

  1. Hubungkan perangkat target. Jalankan perintah berikut dari direktori SDK yang telah diekstrak.
    cd example
    flutter pub get
    flutter run
    
  2. Pada layar utama aplikasi contoh, buka 百炼(DashScope). Pilih endpoint layanan dan masukkan API Key. Jika menggunakan domain khusus ruang kerja, masukkan juga WorkspaceId.
  3. Buka Qwen-Audio-3.x-ASR-Flash-Message/Qwen-Audio-3.x-ASR-Flash-Streaming/Fun-ASR-Realtime 实时语音识别 dan jalankan contoh. Izinkan akses mikrofon saat menjalankan contoh perekaman audio.
Contoh lengkap ada di example/lib/pages/dashscope/dash_fun_asr_speech_transcriber_page.dart dalam paket SDK.

Model dalam contoh yang disertakan

Contoh bawaan merekam audio pada 16 kHz. Untuk menjalankannya langsung, pilih model yang menerima audio 16 kHz. Untuk menggunakan fun-asr-flash-8k-realtime, ubah laju sampel rekaman di example/lib/audio_input.dart menjadi 8 kHz, lalu tetapkan nls_config.sample_rate ke 8000 dalam permintaan.
  • qwen-audio-3.1-asr-flash-message
  • qwen-audio-3.1-asr-flash-streaming
  • qwen-audio-3.0-asr-flash-streaming
  • fun-asr-realtime
  • fun-asr-flash-8k-realtime

Urutan pemanggilan

Panggil metode berikut pada instance yang diperoleh dari NativeNui(). Gunakan JSON koneksi dan JSON tugas pada bagian Parameter permintaan sebagai initJson dan sessionJson. Pastikan setiap panggilan berhasil sebelum melanjutkan.
  1. Berlangganan eventStream sebelum memanggil metode berikut.
  2. Atur parameter koneksi dan tugas, lalu mulai sesi.
    await nui.nuiInitialize(params: initJson);
    await nui.dialogSetParams(sessionJson);
    await nui.dialogStart(vadMode: VadMode.p2t.code, dialogParams: sessionJson);
    
  3. Setelah sesi dimulai, rekam audio dan kirim potongan PCM menggunakan sendAudio.
  4. Hentikan perekaman lalu panggil dialogStop. Setelah menangani peristiwa terakhir, panggil nuiRelease dan batalkan langganan.

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 contoh sebagai string ke metode Dart.
{
  "device_id": "YOUR_DEVICE_ID",
  "url": "wss://YOUR_WS_HOST/api-ws/v1/inference",
  "service_mode": "1"
}

Parameter tugas

Teruskan JSON contoh sebagai string ke metode Dart.
{
  "apikey": "YOUR_API_KEY",
  "nls_config": {
    "model": "qwen-audio-3.1-asr-flash-message",
    "sample_rate": 16000,
    "sr_format": "pcm"
  },
  "service_type": 4
}
Sesuaikan nls_config.sample_rate dan nls_config.sr_format dengan audio masukan. Contoh ini menggunakan PCM 16 kHz. Atur opsi seperti kosakata dan konteks sesuai dokumentasi model.

Referensi API

Metode

Untuk metode yang mengembalikan Future<int>, kode 0 menandakan keberhasilan. Jenis hasil dari sendAudio adalah Future<Object?>.
Tanda tangan metodeKegunaan
Future<int> nuiInitialize({required String params, int logLevel = 0, bool saveLog = false})Inisialisasi SDK dengan parameter koneksi sebagai string JSON.
Future<int> dialogSetParams(String params)Atur parameter JSON untuk sesi saat ini.
Future<int> dialogStart({required int vadMode, String dialogParams = "{}"})Mulai sesi. vadMode memilih mode segmentasi dan dialogParams menerima parameter sesi khusus sebagai string JSON.
Future<Object?> sendAudio(Uint8List data)Kirim satu potongan audio PCM.
Future<int> dialogStop()Akhiri sesi perekaman saat ini dan pertahankan koneksi.
Future<int> dialogCancel()Batalkan sesi atau tugas sintesis saat ini.
Future<int> nuiRelease()Lepaskan sumber daya SDK.
Future<String?> getAllResponse()Baca respons pengenalan lengkap terbaru.

Peristiwa dan stream audio

Baca peristiwa dari eventStream. Jika peristiwa dikirim sebagai map Dart, gunakan event untuk membaca nama peristiwa dan resultCode untuk memeriksa kegagalan tugas. Lihat cara contoh menangani asrResult dan asrAllResponse untuk membaca hasil pengenalan.
PeristiwaKegunaan
EVENT_ASR_PARTIAL_RESULTHasil pengenalan sementara
EVENT_SENTENCE_ENDHasil pengenalan akhir untuk kalimat saat ini
EVENT_TRANSCRIBER_COMPLETETugas atau keluaran audio saat ini selesai
EVENT_ASR_ERRORTugas gagal