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é.
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 connexion dans
Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
Choisissez une
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-Audio-TTS/CosyVoice 双向流式语音合成 et exécutez l’exemple.
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-flashqwen-audio-3.1-tts-plusqwen-audio-3.0-tts-flashqwen-audio-3.0-tts-pluscosyvoice-v3-flashcosyvoice-v3-plus
Ordre des appels
Appelez ces méthodes sur l’instance renvoyée par NativeNui().
-
Abonnez-vous à
streamTtsEventStreametstreamTtsAudioStreamavant d’appeler les méthodes. -
Utilisez le JSON de connexion et le JSON de la tâche ci-dessous comme
ticketJsonetparamsJson.Une fois la synthèse lancée, envoyez le texte par fragments et lisez le son reçu dans le flux. -
Terminez l’envoi de texte avec
streamTtsStop. Après l’événement de fin de synthèse, appelezstreamTtsRelease.
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.
Paramètres de la tâche
Passez le JSON de l’exemple à la méthode Dart sous forme de chaîne.
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éthode | Utilisation |
|---|---|
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énement | Utilisation |
|---|---|
STREAM_INPUT_TTS_EVENT_SYNTHESIS_STARTED | Dé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_COMPLETE | Fin de la tâche ou de la sortie audio en cours |
STREAM_INPUT_TTS_EVENT_TASK_FAILED | Échec de la tâche |