Skip to main content

Qwen-Audio-TTS / CosyVoice Flutter SDK

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

Qwen-Audio-TTS et CosyVoice utilisent la même API de synthèse en streaming bidirectionnel. L’application peut envoyer des fragments de texte tout en recevant l’audio synthétisé.

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-Audio-TTS/CosyVoice 双向流式语音合成 et exécutez l’exemple.
Le code complet se trouve dans example/lib/pages/dashscope/dash_cosy_voice_stream_tts_page.dart dans le package du SDK.

Modèles inclus dans l’exemple

  • qwen-audio-3.1-tts-flash
  • qwen-audio-3.1-tts-plus
  • qwen-audio-3.0-tts-flash
  • qwen-audio-3.0-tts-plus
  • cosyvoice-v3-flash
  • cosyvoice-v3-plus

Ordre des appels

Appelez ces méthodes sur l’instance renvoyée par NativeNui().
  1. Abonnez-vous à streamTtsEventStream et streamTtsAudioStream avant d’appeler les méthodes.
  2. Utilisez le JSON de connexion et le JSON de la tâche ci-dessous comme ticketJson et paramsJson.
    await nui.streamTtsStart(ticket: ticketJson, params: paramsJson);
    await nui.streamTtsSend('你好,');
    await nui.streamTtsSend('欢迎使用语音合成。');
    
    Une fois la synthèse lancée, envoyez le texte par fragments et lisez le son reçu dans le flux.
  3. Terminez l’envoi de texte avec streamTtsStop. Après l’événement de fin de synthèse, appelez streamTtsRelease.

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 Android SDK, iOS SDK, HarmonyOS SDK. 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 connexion dans ticket.
{
  "apikey": "YOUR_API_KEY",
  "device_id": "YOUR_DEVICE_ID",
  "url": "wss://YOUR_WS_HOST/api-ws/v1/inference"
}

Paramètres de la tâche

Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
{
  "model": "qwen-audio-3.1-tts-flash",
  "voice": "longanhuan_v3.1",
  "format": "pcm",
  "enable_audio_decoder": false,
  "sample_rate": 24000,
  "volume": 50,
  "rate": 1.0,
  "pitch": 1.0
}
Choisissez une voice compatible avec le model. format et sample_rate règlent le format et la fréquence d’échantillonnage de sortie. L’exemple active enable_audio_decoder pour le MP3 ou l’Opus.

Référence de l’API

Méthodes

Pour les méthodes qui renvoient Future<int>, le code 0 indique la réussite.
Signature de la méthodeUtilisation
Future<int> streamTtsStart({required String ticket, required String params, String sessionId = "", int logLevel = 0, bool saveLog = false})Crée une session de synthèse en streaming. Passez ticket et params dans deux chaînes JSON séparées.
Future<int> streamTtsSend(String text)Envoie le fragment de texte suivant.
Future<int> streamTtsStop({bool flagAsync = true})Termine l’envoi de texte. flagAsync vaut true par défaut pour un arrêt asynchrone.
Future<int> streamTtsAsyncPlay({required String ticket, required String params, required String text, String sessionId = "", int logLevel = 0, bool saveLog = false})Envoie tout le texte en un seul appel et reçoit le résultat de manière asynchrone.
Future<int> streamTtsCancel()Annule la session ou la tâche de synthèse en cours.
Future<int> streamTtsRelease()Libère les ressources du SDK.

Événements et flux audio

Lisez les événements dans streamTtsEventStream. 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 streamTtsAudioStream fournit les blocs audio à lire dans l’application.
ÉvénementUtilisation
STREAM_INPUT_TTS_EVENT_SYNTHESIS_STARTEDDébut de la synthèse ou de la réponse audio
STREAM_INPUT_TTS_EVENT_SENTENCE_SYNTHESISÉvénement de synthèse au niveau de la phrase
STREAM_INPUT_TTS_EVENT_SYNTHESIS_COMPLETEFin de la tâche ou de la sortie audio en cours
STREAM_INPUT_TTS_EVENT_TASK_FAILEDÉchec de la tâche