Skip to main content

Qwen-Audio-ASR / Fun-ASR Flutter SDK

Integra Qwen-Audio-ASR / Fun-ASR con el SDK de Flutter. Consulta la secuencia de llamadas en Dart, los parámetros de la solicitud y los eventos.

Qwen-Audio-ASR-Message, Qwen-Audio-ASR-Streaming y Fun-ASR transcriben voz en tiempo real y comparten las API de sesión y entrada de audio. Usa nls_config.model para seleccionar el modelo.

Requisitos previos

  • Configure un entorno de desarrollo de Flutter para la plataforma de destino. La aplicación de ejemplo requiere Dart 3.4 o posterior, con una versión inferior a 4.0.
  • Obtenga una clave de API. Seleccione un punto de conexión en la misma región que la clave de API. Si usa un dominio específico del espacio de trabajo, obtenga también el ID del espacio de trabajo.
No incluya claves de API de larga duración en el código de una aplicación móvil. En los modelos que admiten claves de API temporales, use el servidor de la aplicación para generar una clave de API temporal y enviarla al cliente.

Instalar el SDK

Abra Selección y descarga del SDK móvil de voz, seleccione la pestaña Flutter y descargue y extraiga el paquete. Copie el directorio extraído del SDK a packages/aliyun_neonui en el proyecto de Flutter y agregue la dependencia local en pubspec.yaml.
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
Ejecute flutter pub get y luego importe el SDK en el archivo Dart.
import 'package:aliyun_neonui/neonui.dart';

Inicio rápido

Ejecutar la aplicación de ejemplo

  1. Conecte el dispositivo de destino. Ejecute estos comandos desde el directorio extraído del SDK.
    cd example
    flutter pub get
    flutter run
    
  2. En la pantalla de inicio de la aplicación de ejemplo, abra 百炼(DashScope). Seleccione un punto de conexión e introduzca su API Key. Si usa un dominio específico del espacio de trabajo, introduzca también el WorkspaceId.
  3. Abre Qwen-Audio-3.x-ASR-Flash-Message/Qwen-Audio-3.x-ASR-Flash-Streaming/Fun-ASR-Realtime 实时语音识别 y ejecuta el ejemplo. Concede acceso al micrófono si el ejemplo captura audio.
El código completo está en example/lib/pages/dashscope/dash_fun_asr_speech_transcriber_page.dart dentro del paquete del SDK.

Modelos incluidos en el ejemplo

El ejemplo incluido graba el audio a 16 kHz. Para ejecutarlo tal cual, elige un modelo que acepte audio a 16 kHz. Si usas fun-asr-flash-8k-realtime, cambia la frecuencia de muestreo de la grabación a 8 kHz en example/lib/audio_input.dart y establece nls_config.sample_rate en 8000 en la solicitud.
  • 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

Orden de las llamadas

Llama a estos métodos en la instancia que devuelve NativeNui(). Usa el JSON de conexión y el JSON de la tarea de Parámetros de la solicitud como initJson y sessionJson. Comprueba que cada llamada se complete correctamente antes de continuar.
  1. Suscríbete a eventStream antes de llamar a los métodos.
  2. Define los parámetros de conexión y de la tarea e inicia la sesión.
    await nui.nuiInitialize(params: initJson);
    await nui.dialogSetParams(sessionJson);
    await nui.dialogStart(vadMode: VadMode.p2t.code, dialogParams: sessionJson);
    
  3. Cuando se abra la sesión, captura el audio y envía bloques PCM con sendAudio.
  4. Detén la captura y llama a dialogStop. Después de procesar los últimos eventos, llama a nuiRelease y cancela las suscripciones.

Parámetros de solicitud

Este ejemplo usa un modelo incluido en el paquete. Consulta example/lib/dashscope_params.dart para otras opciones de configuración. Para más información sobre los parámetros, consulta Android SDK, iOS SDK, HarmonyOS SDK. Sustituye YOUR_WS_HOST por el host WebSocket de tu región, YOUR_DEVICE_ID por un identificador de dispositivo y YOUR_API_KEY por una clave de API de esa región.

Parámetros de conexión

Pasa el JSON del ejemplo como cadena al método de Dart.
{
  "device_id": "YOUR_DEVICE_ID",
  "url": "wss://YOUR_WS_HOST/api-ws/v1/inference",
  "service_mode": "1"
}

Parámetros de la tarea

Pasa el JSON del ejemplo como cadena al método de Dart.
{
  "apikey": "YOUR_API_KEY",
  "nls_config": {
    "model": "qwen-audio-3.1-asr-flash-message",
    "sample_rate": 16000,
    "sr_format": "pcm"
  },
  "service_type": 4
}
Ajusta nls_config.sample_rate y nls_config.sr_format al audio de entrada. El ejemplo usa PCM a 16 kHz. Configura el vocabulario y el contexto según la documentación de cada modelo.

Referencia de la API

Métodos

En los métodos que devuelven Future<int>, el código 0 indica éxito. sendAudio devuelve Future<Object?>.
Firma del métodoFinalidad
Future<int> nuiInitialize({required String params, int logLevel = 0, bool saveLog = false})Inicializa el SDK con los parámetros de conexión como cadena JSON.
Future<int> dialogSetParams(String params)Define los parámetros JSON de la sesión actual.
Future<int> dialogStart({required int vadMode, String dialogParams = "{}"})Inicia la sesión. vadMode selecciona el modo de segmentación y dialogParams admite los parámetros de la sesión como cadena JSON.
Future<Object?> sendAudio(Uint8List data)Envía un bloque de audio PCM.
Future<int> dialogStop()Termina la sesión de captura actual y mantiene abierta la conexión.
Future<int> dialogCancel()Cancela la sesión o la tarea de síntesis actual.
Future<int> nuiRelease()Libera los recursos del SDK.
Future<String?> getAllResponse()Lee la última respuesta completa del reconocimiento.

Eventos y flujos de audio

Lee los eventos desde eventStream. Si un evento se entrega como mapa de Dart, lee su nombre desde event y consulta resultCode para ver los errores. Consulta cómo el ejemplo procesa asrResult y asrAllResponse para leer los resultados del reconocimiento.
EventoFinalidad
EVENT_ASR_PARTIAL_RESULTResultado parcial del reconocimiento
EVENT_SENTENCE_ENDResultado final del reconocimiento de la frase actual
EVENT_TRANSCRIBER_COMPLETEFinalización de la tarea o de la salida de audio actual
EVENT_ASR_ERRORError de la tarea