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.
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
Exécutez
Appelez ces méthodes sur l’instance renvoyée par
L’exemple utilise un modèle inclus dans le package. Pour les autres réglages, consultez
Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
Le paramètre
Pour les méthodes qui renvoient
Lisez les événements dans
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.
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.
flutter pub get, puis importez le SDK dans votre fichier Dart.
Démarrage rapide
Exécuter l’application d’exemple
-
Connectez l’appareil cible. Exécutez les commandes suivantes dans le répertoire extrait du SDK.
- 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.
- Ouvrez Qwen-LiveTranslate 实时音视频翻译 et exécutez l’exemple. Autorisez l’accès au microphone si l’exemple capture du son.
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.
-
Abonnez-vous à
eventStreametttsAudioStreamavant d’appeler les méthodes. -
Définissez les paramètres de connexion et de la tâche, puis ouvrez la session.
-
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. -
Arrêtez la capture et appelez
dialogStop. Après avoir traité les derniers événements, appeleznuiReleaseet 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.
Paramètres de la tâche
Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
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éthode | Utilisation |
|---|---|
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énement | Utilisation |
|---|---|
EVENT_ASR_PARTIAL_RESULT | Résultat intermédiaire de la reconnaissance |
EVENT_RESULT_TRANSLATED | Résultat de la traduction |
EVENT_RESULT_TRANSLATED_END | Traduction finale de la phrase en cours |
EVENT_TRANSCRIBER_COMPLETE | Fin de la tâche ou de la sortie audio en cours |
EVENT_ASR_ERROR | Échec de la tâche |