Skip to main content

Qwen-Livetranslate-Realtime Flutter SDK

Integra Qwen-Livetranslate-Realtime con el SDK de Flutter. Consulta la secuencia de llamadas en Dart, los parámetros de la solicitud y los eventos.

Qwen-Livetranslate-Realtime recibe audio en tiempo real y devuelve traducciones. La aplicación puede recibir texto traducido o texto y audio.

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-LiveTranslate 实时音视频翻译 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_live_translate_page.dart dentro del paquete del SDK.

Modelos incluidos en el ejemplo

  • qwen3.5-livetranslate-flash-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 y ttsAudioStream 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. El ejemplo de grabación captura PCM mono de 16 bits a 16 kHz. En iOS, inicia el micrófono antes del reproductor de audio. Si el reproductor ya está activo, reinícialo después de iniciar el micrófono para que pueda reproducir el audio de la respuesta.
  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 la guía de integración con WebSocket. 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/realtime?model=qwen3.5-livetranslate-flash-realtime",
  "service_mode": "1",
  "audio_update_manually": "false"
}

Parámetros de la tarea

Pasa el JSON del ejemplo como cadena al método de Dart.
{
  "apikey": "YOUR_API_KEY",
  "nls_config": {
    "sample_rate": 16000,
    "sr_format": "pcm",
    "modalities": "[\"text\",\"audio\"]",
    "source_language": "zh",
    "translation": "{\"language\":\"en\"}",
    "turn_detection": "{\"type\":\"server_vad\",\"threshold\":0.2,\"silence_duration_ms\":1000}"
  },
  "service_type": 4
}
El parámetro model de la URL selecciona el modelo de traducción. nls_config.model permite el reconocimiento opcional del idioma de origen. translation es una cadena JSON que contiene el idioma de destino en language. Omite source_language para detectarlo automáticamente.

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.

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. El flujo ttsAudioStream proporciona bloques de audio para que la aplicación los reproduzca.
EventoFinalidad
EVENT_ASR_PARTIAL_RESULTResultado parcial del reconocimiento
EVENT_RESULT_TRANSLATEDResultado de la traducción
EVENT_RESULT_TRANSLATED_ENDTraducción final de la frase actual
EVENT_TRANSCRIBER_COMPLETEFinalización de la tarea o de la salida de audio actual
EVENT_ASR_ERRORError de la tarea