Intégrez Paraformer avec le SDK Flutter. Consultez l’ordre des appels Dart, les paramètres de requête et les événements.
Paraformer transcrit l’audio du microphone en temps réel. Sélectionnez un modèle et utilisez la fréquence d’échantillonnage correspondante.
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
L’exemple fourni enregistre le son à 16 kHz. Pour l’exécuter tel quel, choisissez un modèle qui accepte l’audio à 16 kHz. Pour utiliser
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.
L’exemple utilise
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 Paraformer 实时语音识别 et exécutez l’exemple. Autorisez l’accès au microphone si l’exemple capture du son.
example/lib/pages/dashscope/dash_paraformer_speech_transcriber_page.dart dans le package du SDK.
Modèles inclus dans l’exemple
L’exemple fourni enregistre le son à 16 kHz. Pour l’exécuter tel quel, choisissez un modèle qui accepte l’audio à 16 kHz. Pour utiliser paraformer-realtime-8k-v2, réglez la fréquence d’échantillonnage de l’enregistrement sur 8 kHz dans example/lib/audio_input.dart et définissez nls_config.sample_rate sur 8000 dans la requête.
paraformer-realtime-v2paraformer-realtime-8k-v2
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 à
eventStreamavant 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. -
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 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 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.
paraformer-realtime-v2 avec du PCM à 16 kHz. Pour paraformer-realtime-8k-v2, capturez à 8 kHz et indiquez cette fréquence dans la requête.
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. |
Future<String?> getAllResponse() | Lit la dernière réponse de reconnaissance complète. |
É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.
Pour lire les résultats de reconnaissance, consultez le traitement de asrResult et asrAllResponse dans l’exemple.
| Événement | Utilisation |
|---|---|
EVENT_ASR_PARTIAL_RESULT | Résultat intermédiaire de la reconnaissance |
EVENT_SENTENCE_END | Résultat final de la reconnaissance 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 |