Ce guide explique comment utiliser le SDK HarmonyOS de reconnaissance vocale non temps réel Qwen-Audio-ASR-Filetrans pour convertir la parole en texte.
Démarrage rapide
- Obtenir une clé API : Obtenir une clé API. Pour des raisons de sécurité, nous recommandons de configurer la clé API comme variable d'environnement.
- Télécharger le SDK et exécuter l'exemple de code :
- Télécharger le dernier package SDK.
- Extrayez le package TAR. Obtenez le SDK au format HAR depuis le répertoire
neonuiet ajoutez-le aux dépendances de votre projet. Pour l'intégration C++, obtenez les bibliothèques dynamiques et les fichiers d'en-tête depuisnative/libsetnative/includedans le package TAR. - Ouvrez le projet dans DevEco Studio. L'exemple de code se trouve dans
DashFunAsrFileTranscriberPage.ets. Remplacez la clé API pour tester la fonctionnalité.
Étapes d'appel
Mode synchrone
- Initialiser le SDK.
- Configurez les paramètres en fonction de vos besoins métier.
- Appelez
startFileTranscriberpour démarrer une tâche de reconnaissance avecasync_requestdéfini surfalse. - Dans l'interface
onFileTransEventCallback, écoutez l'événementEVENT_FILE_TRANS_RESULTpour obtenir le résultat final de la reconnaissance. - Appelez
releasepour libérer les ressources du SDK.
Mode asynchrone
- Initialiser le SDK.
- Configurez les paramètres en fonction de vos besoins métier.
- Appelez
startFileTranscriberpour démarrer une tâche de reconnaissance avecasync_requestdéfini surtrue. - Appelez
queryFileTranscriberpour interroger la progression ou le résultat de la reconnaissance. - Dans l'interface
onFileTransEventCallback, écoutez l'événementEVENT_FILE_TRANS_QUERY_RESULTpour obtenir le résultat de requête actuel. - Dans l'interface
onFileTransEventCallback, écoutez l'événementEVENT_FILE_TRANS_RESULTpour obtenir le résultat final de la reconnaissance. - Appelez
releasepour libérer les ressources du SDK.
Paramètres de la requête
Paramètres de connexion et de contrôle
Passez une chaîne JSON au paramètre parameters de initializeFileTrans pour configurer les paramètres suivants.
Exemple
La chaîne JSON suivante est un exemple et n'inclut pas tous les paramètres. Ajoutez les paramètres selon vos besoins :
{
"url": "wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/asr/transcription",
"apikey": "st-****",
"device_id": "my_device_id",
"service_mode": "1"
}
Descriptions des paramètres
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
|
| Oui | Le point de terminaison. Celui-ci est fixé à |
|
| Oui | La clé API. Nous recommandons d'utiliser une clé API temporaire plus sécurisée avec une courte période de validité afin de réduire le risque de fuite d'une clé à long terme. |
|
| Oui | Le mode de fonctionnement. Pour la reconnaissance vocale non temps réel, cette valeur est fixée à |
|
| Oui | Une chaîne unique identifiant l'utilisateur final. Vous pouvez la définir sur un ID utilisateur in-app ou un identifiant d'appareil unique généré par le client. Cet ID est principalement utilisé pour le suivi des journaux et le dépannage. |
|
| Non | Le chemin de stockage des fichiers journaux. Ce paramètre prend effet uniquement si vous définissez |
|
| Non | Définit la taille maximale d'un fichier journal en octets. Ce paramètre prend effet uniquement si vous définissez |
Paramètres d'effet de reconnaissance vocale
Configurez le paramètre nls_config en utilisant setParams, ou configurez tous les paramètres d'effet de reconnaissance vocale en utilisant startFileTranscriber.
Exemple
La chaîne JSON suivante est un exemple et n'inclut pas tous les paramètres. Ajoutez les paramètres selon vos besoins :
{
"file_urls": [
"{YOUR_AUDIO_URL}"
],
"async_request": false,
"nls_config": {
"model":"qwen-audio-3.0-asr-flash-filetrans",
"diarization_enabled": false,
"parameters": {
"speech_noise_threshold": 0.0
}
}
}
Descriptions des paramètres
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
|
| Oui | Une liste d'URL pour les fichiers audio ou vidéo à transcrire. HTTP et HTTPS sont pris en charge. Une seule requête prend en charge uniquement 1 URL. Pour les exigences d'entrée telles que les formats audio pris en charge et les limites de taille et de durée des fichiers, voir Spécifications audio. Si un fichier audio est stocké dans Alibaba Cloud OSS, l'API RESTful prend en charge une URL temporaire avec le préfixe Important
- Si une URL publique OSS temporaire n'est pas accessible, définissez l'en-tête de requête |
|
| Non | Spécifie s'il faut utiliser une requête asynchrone. Valeur par défaut : |
|
| Non | Si |
|
| Oui | L'objet de configuration principal de la reconnaissance vocale, qui contient les paramètres clés pour la sélection du modèle et le contrôle de l'effet de reconnaissance. |
|
| Oui | Le nom du modèle. |
|
| Non | Spécifie les mots sensibles à traiter lors de la reconnaissance vocale et prend en charge différentes méthodes de traitement pour différents mots. Pour plus d'informations, voir Filtrage des mots sensibles. |
|
| Non | Spécifie les index des pistes audio à reconnaître dans un fichier audio multipiste. Les index commencent à 0. Par exemple, ImportantChaque piste spécifiée est facturée séparément. Par exemple, Valeur par défaut : |
|
| Non | Spécifie s'il faut activer la diarisation des locuteurs. Cette fonctionnalité est désactivée par défaut. Elle s'applique uniquement à l'audio mono. L'audio multicanal ne prend pas en charge la diarisation des locuteurs. Lorsqu'elle est activée, le résultat de reconnaissance contient RemarqueSi la diarisation des locuteurs est activée, nous recommandons de limiter la durée audio à 2 heures pour éviter un échec de reconnaissance ou un délai d'expiration. Valeur par défaut : false. Pour un exemple de |
|
| Non | ImportantCe paramètre prend effet uniquement lorsque la diarisation des locuteurs est activée en définissant Il fournit une valeur de référence pour le nombre de locuteurs. Les valeurs valides sont des entiers de 2 à 100. Par défaut, le nombre de locuteurs est déterminé automatiquement. Si ce paramètre est défini, il guide uniquement l'algorithme pour produire le nombre spécifié et ne garantit pas ce nombre. Aucune valeur par défaut. |
|
| Non | L'ID de la liste de mots clés précompilés. Créez d'abord une liste de mots clés et transmettez son ID lors de la reconnaissance pour utiliser les mots clés de la liste. Cela convient lorsque le vocabulaire est connu et relativement stable et que le même vocabulaire doit être réutilisé entre les requêtes. Pour plus d'informations, voir Mots clés précompilés. |
|
| Non | Spécifie les codes de langue pour l'audio à reconnaître. Si la langue ne peut pas être déterminée à l'avance, omettez ce paramètre et le modèle détecte automatiquement la langue. Vous pouvez définir jusqu’à 4 valeurs. Au-delà, seules les 4 premières sont prises en compte. Cliquez pour afficher les codes de langue pris en charge
|
|
| Non | Configure des paramètres supplémentaires sous forme d'objet JSON. |
Interfaces clés
NativeNui
initializeFileTrans
Initialise une instance SDK de transcription vocale. Ne réinitialisez pas l'instance avant d'avoir appelé release.
RemarqueContrairement à la reconnaissance vocale en temps réel, la transcription de fichiers audio non temps réel doit utiliser initializeFileTrans et passer un rappel INativeFileTransCallback au lieu d'utiliser initialize.
Cette interface bloque le thread appelant. Appelez-la depuis un thread non UI.
Signature de la méthode
public initializeFileTrans(callback: INativeFileTransCallback,
parameters: string,
level: number,
save_log: boolean = false): number
Descriptions des paramètres
| Paramètre | Type | Description |
|---|---|---|
|
| Une implémentation de l'interface de rappel d'événements et de données de transcription de fichiers. |
|
| Une chaîne JSON contenant des paramètres d'authentification, de connexion et de débogage. Voir Paramètres de connexion et de contrôle. |
|
| Contrôle le niveau de journalisation du SDK. Les valeurs valides sont définies par l'énumération |
|
| Spécifie s'il faut enregistrer les journaux locaux. Si ce paramètre est |
setParams
Définit ou met à jour uniquement le paramètre nls_config. Si tous les paramètres sont fournis dans startFileTranscriber, vous n'avez pas besoin d'appeler cette méthode.
Signature de la méthode
public setParams(params: string): number
Descriptions des paramètres
| Paramètre | Type | Description |
|---|---|---|
|
| Le paramètre |
startFileTranscriber
Démarre la reconnaissance.
Signature de la méthode
public startFileTranscriber(params: string, task_id: ArrayBuffer): number
Descriptions des paramètres
| Paramètre | Type | Description |
|---|---|---|
|
| Les paramètres d'effet de reconnaissance vocale. Exemple : |
|
| Le tampon d'ID de tâche. Le SDK écrit une chaîne d'ID de tâche aléatoire générée en interne dans ce tampon. Le tampon doit avoir une longueur d'au moins 33 octets. L'exemple utilise |
queryFileTranscriber
Interroge l'état actuel et le résultat d'une tâche asynchrone. Après un appel réussi, le résultat est retourné par l'événement EVENT_FILE_TRANS_QUERY_RESULT dans le rappel onFileTransEventCallback.
Signature de la méthode
public queryFileTranscriber(task_id: string): number
Descriptions des paramètres
| Paramètre | Type | Description |
|---|---|---|
|
| L'ID de la tâche à interroger, obtenu à partir du tampon écrit par |
cancelFileTranscriber
Annule immédiatement la tâche en cours.
Signature de la méthode
public cancelFileTranscriber(task_id: string): number
Descriptions des paramètres
| Paramètre | Type | Description |
|---|---|---|
|
| L'ID de la tâche à annuler. |
release
Libère toutes les ressources internes du SDK. Après l'appel de cette méthode, l'instance SDK devient indisponible. Pour la réutiliser, appelez initializeFileTrans pour la réinitialiser.
Signature de la méthode
public release(): number
GetVersion
Obtient les informations de version actuelles du SDK.
Signature de la méthode
public GetVersion(): string
Valeur de retour
Les informations de version actuelle du SDK.
INativeFileTransCallback
Définit les rappels pour les événements de transcription de fichiers et les résultats de reconnaissance.
onFileTransEventCallback
Écoute les événements de transcription de fichiers et obtient les résultats de reconnaissance vocale.
Signature de la méthode
onFileTransEventCallback: (event: Constants.NuiEvent, resultCode: number, finish: number,
asrResult: AsrResult, taskId: string) => void;
Descriptions des paramètres
| Paramètre | Type | Description |
|---|---|---|
|
| L'événement de rappel. |
|
| Valide uniquement lorsque l’événement |
|
| Indique si la tâche est terminée. |
|
| Le résultat de la reconnaissance vocale. |
|
| L'ID de la tâche. |
Constants.NuiEvent
Les types d'événements du SDK HarmonyOS sont définis par l'énumération Constants.NuiEvent. Les événements suivants s'appliquent à la transcription de fichiers audio :
| Événement | Description |
|---|---|
| Le service est connecté. |
| Le fichier audio à reconnaître est téléchargé. |
| Le résultat de la requête de tâche. |
| Le résultat final de la reconnaissance. |
| Une erreur s'est produite lors de la reconnaissance vocale. |
Types auxiliaires
Constants.LogLevel
Les valeurs d'énumération pour le paramètre level sont les suivantes :
| Valeur | Description |
|---|---|
| Les journaux les plus détaillés. |
| Journaux de débogage. |
| Journaux d'information (par défaut). |
| Journaux d'avertissement. |
| Journaux d'erreurs. |
| Désactive la journalisation. |
Télécharger le résultat
Les résultats de la reconnaissance vocale non temps réel sont générés de manière asynchrone. La réponse retournée par l'événement EVENT_FILE_TRANS_RESULT contient transcription_url. Téléchargez le texte de reconnaissance au format JSON depuis cette URL. L'URL a une période de validité. Téléchargez le résultat rapidement.