Intégrez Sambert avec le SDK Flutter. Consultez l’ordre des appels Dart, les paramètres de requête et les événements.
Sambert utilise un flux unidirectionnel. L’application envoie le texte complet et reçoit l’audio synthétisé par blocs.
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.
Définissez chaque paramètre avec
Pour Sambert,
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 Sambert 单向流式语音合成 et exécutez l’exemple.
example/lib/pages/dashscope/dash_sambert_tts_page.dart dans le package du SDK.
Modèles inclus dans l’exemple
sambert-zhinan-v1
Ordre des appels
Appelez ces méthodes sur l’instance renvoyée par NativeNui().
-
Abonnez-vous à
ttsEventStreametttsAudioStreamavant d’appeler les méthodes. -
Utilisez le JSON de connexion ci-dessous comme
initJson. Transmettez les paramètres de la tâche àttsSetParamsous forme de paires clé-valeur.Après l’initialisation, définissez les paramètres de la tâche un par un. Envoyez le texte complet avecttsStartet récupérez le son dans le flux. -
L’événement
TTS_EVENT_ENDindique que le SDK a fini d’envoyer le son. Appelez ensuitettsRelease.
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.
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
Définissez chaque paramètre avec ttsSetParam(key, value). Passez les valeurs numériques sous forme de chaînes, comme dans l’exemple.
model sélectionne l’identifiant du modèle associé à la voix. L’exemple utilise une voix à 48 kHz incluse dans le package. Lisez le son à la même fréquence.
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> ttsInitialize({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> ttsSetParam(String key, String value) | Définit un paramètre de la tâche sous forme de chaîne. |
Future<int> ttsStart({required String priority, required String taskId, required String text}) | Envoie le texte complet. L’exemple utilise priority: '1' et taskId: ''. |
Future<int> ttsPause() | Met la synthèse en pause. |
Future<int> ttsResume() | Reprend la synthèse. |
Future<int> ttsCancel(String taskId) | Annule la synthèse à partir de l’identifiant de tâche. |
Future<String?> ttsGetParam(String key) | Lit un paramètre. Utilisez error_msg pour consulter le détail de l’erreur. |
Future<int> ttsRelease() | Libère les ressources du SDK. |
Événements et flux audio
Lisez les événements dans ttsEventStream. 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 |
|---|---|
TTS_EVENT_START | Début de la synthèse ou de la réponse audio |
TTS_EVENT_END | Fin de la tâche ou de la sortie audio en cours |
TTS_EVENT_CANCEL | Annulation de la tâche |
TTS_EVENT_ERROR | Échec de la tâche |