Skip to main content

Qwen-Livetranslate-Realtime Flutter SDK

Intégrez Qwen-Livetranslate-Realtime avec le SDK Flutter. Consultez l’ordre des appels Dart, les paramètres de requête et les événements.

Qwen-Livetranslate-Realtime traduit l’audio en temps réel. L’application peut recevoir du texte traduit ou du texte et de l’audio.

Prérequis

  • Configurez l’environnement de développement Flutter pour la plateforme cible. L’application d’exemple requiert Dart 3.4 ou une version ultérieure, inférieure à 4.0.
  • Obtenez une clé API. Sélectionnez un point de terminaison dans la même région que la clé API. Si vous utilisez un domaine propre à votre espace de travail, récupérez également l’ID de l’espace de travail.
Ne codez pas en dur de clé API de longue durée dans une application mobile. Pour les modèles qui acceptent une clé API temporaire, utilisez le serveur de l’application pour générer une clé API temporaire et la transmettre au client.

Installer le SDK

Ouvrez la page Sélection et téléchargement du SDK vocal mobile, sélectionnez l’onglet Flutter, puis téléchargez et extrayez le package. Copiez le répertoire extrait du SDK vers packages/aliyun_neonui dans votre projet Flutter, puis ajoutez la dépendance locale à pubspec.yaml.
dependencies:
  aliyun_neonui:
    path: packages/aliyun_neonui
Exécutez flutter pub get, puis importez le SDK dans votre fichier Dart.
import 'package:aliyun_neonui/neonui.dart';

Démarrage rapide

Exécuter l’application d’exemple

  1. Connectez l’appareil cible. Exécutez les commandes suivantes dans le répertoire extrait du SDK.
    cd example
    flutter pub get
    flutter run
    
  2. Sur l’écran d’accueil de l’application d’exemple, ouvrez 百炼(DashScope). Sélectionnez un point de terminaison et saisissez votre API Key. Si vous utilisez un domaine propre à votre espace de travail, saisissez aussi votre WorkspaceId.
  3. Ouvrez Qwen-LiveTranslate 实时音视频翻译 et exécutez l’exemple. Autorisez l’accès au microphone si l’exemple capture du son.
Le code complet se trouve dans example/lib/pages/dashscope/dash_live_translate_page.dart dans le package du SDK.

Modèles inclus dans l’exemple

  • qwen3.5-livetranslate-flash-realtime

Ordre des appels

Appelez ces méthodes sur l’instance renvoyée par NativeNui(). Utilisez le JSON de connexion et le JSON de la tâche de la section Paramètres de la requête pour initJson et sessionJson. Vérifiez le résultat de chaque appel avant de continuer.
  1. Abonnez-vous à eventStream et ttsAudioStream avant d’appeler les méthodes.
  2. Définissez les paramètres de connexion et de la tâche, puis ouvrez la session.
    await nui.nuiInitialize(params: initJson);
    await nui.dialogSetParams(sessionJson);
    await nui.dialogStart(vadMode: VadMode.p2t.code, dialogParams: sessionJson);
    
  3. Après l’ouverture de la session, capturez le son et envoyez les blocs PCM avec sendAudio. L’exemple d’enregistrement capture du PCM mono 16 bits à 16 kHz. Sous iOS, démarrez le microphone avant le lecteur audio. Si le lecteur est déjà actif, redémarrez-le après le microphone pour que le son de la réponse puisse être lu.
  4. Arrêtez la capture et appelez dialogStop. Après avoir traité les derniers événements, appelez nuiRelease et annulez les abonnements.

Paramètres de requête

L’exemple utilise un modèle inclus dans le package. Pour les autres réglages, consultez example/lib/dashscope_params.dart. Pour en savoir plus sur les paramètres, consultez le guide d’intégration WebSocket. Remplacez YOUR_WS_HOST par l’hôte WebSocket de votre région, YOUR_DEVICE_ID par un identifiant d’appareil et YOUR_API_KEY par une clé API de la même région.

Paramètres de connexion

Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
{
  "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"
}

Paramètres de la tâche

Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
{
  "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
}
Le paramètre model de l’URL sélectionne le modèle de traduction. nls_config.model permet la reconnaissance facultative de la langue source. translation est une chaîne JSON qui contient la langue cible dans language. Omettez source_language pour la détection automatique.

Référence de l’API

Méthodes

Pour les méthodes qui renvoient Future<int>, le code 0 indique la réussite. sendAudio renvoie Future<Object?>.
Signature de la méthodeUtilisation
Future<int> nuiInitialize({required String params, int logLevel = 0, bool saveLog = false})Initialise le SDK avec les paramètres de connexion sous forme de chaîne JSON.
Future<int> dialogSetParams(String params)Définit les paramètres JSON de la session en cours.
Future<int> dialogStart({required int vadMode, String dialogParams = "{}"})Ouvre la session. vadMode sélectionne le mode de segmentation et dialogParams accepte les paramètres de session sous forme de chaîne JSON.
Future<Object?> sendAudio(Uint8List data)Envoie un bloc audio PCM.
Future<int> dialogStop()Termine la session de capture en cours et garde la connexion ouverte.
Future<int> dialogCancel()Annule la session ou la tâche de synthèse en cours.
Future<int> nuiRelease()Libère les ressources du SDK.

Événements et flux audio

Lisez les événements dans eventStream. Si un événement est fourni sous forme de map Dart, lisez son nom dans event et consultez resultCode pour examiner les erreurs. Le flux ttsAudioStream fournit les blocs audio à lire dans l’application.
ÉvénementUtilisation
EVENT_ASR_PARTIAL_RESULTRésultat intermédiaire de la reconnaissance
EVENT_RESULT_TRANSLATEDRésultat de la traduction
EVENT_RESULT_TRANSLATED_ENDTraduction finale de la phrase en cours
EVENT_TRANSCRIBER_COMPLETEFin de la tâche ou de la sortie audio en cours
EVENT_ASR_ERRORÉchec de la tâche