Ce guide vous montre comment convertir la parole en texte avec le SDK Android de reconnaissance vocale non temps réel Fun-ASR.
Pour les exigences d'entrée telles que les formats audio pris en charge, les limites de taille de fichier et les limites de durée, consultez Spécifications audio.
Configurez ces paramètres en transmettant une chaîne JSON dans l'argument
Description des paramètres
Configurez tous les paramètres de reconnaissance vocale via l'interface
Description des paramètres
Initialiser l'instance du SDK de reconnaissance vocale. Le SDK est un singleton. Ne pas l'initialiser à nouveau avant d'appeler
Description des paramètres
Utilisez cette interface pour définir ou mettre à jour les paramètres
Description des paramètres
Démarre la reconnaissance.
Signature de la méthode
Description des paramètres
Utilisez cette interface pour interroger l'état et le résultat actuels d'une tâche asynchrone. Une fois l'appel réussi, le résultat est renvoyé via l'événement
Signature de la méthode
Description des paramètres
Annule immédiatement la tâche en cours.
Signature de la méthode
Description des paramètres
Libérer toutes les ressources internes du SDK. Après l'appel de cette méthode, l'instance du SDK devient inutilisable. Pour l'utiliser à nouveau, appeler
Obtient les informations de version actuelles du SDK.
Signature de la méthode
Valeur de retour
Les informations de version actuelles du SDK.
Signature de la méthode
Description des paramètres
Ce rappel reçoit les journaux internes détaillés du SDK pour le diagnostic et le débogage des problèmes.
Démarrage rapide
- Obtenir une clé API : Obtenir une clé API. Pour une meilleure sécurité, stockez la clé API dans une variable d'environnement.
-
Téléchargez le SDK et exécutez l'exemple de code :
- Téléchargez le dernier package du SDK.
- Extrayez le package ZIP. Trouvez le SDK au format AAR dans le répertoire
app/libset ajoutez-le aux dépendances de votre projet. Pour l'intégration C++ Android, utilisezandroid_libsetandroid_includedans le package ZIP pour obtenir les bibliothèques dynamiques et les fichiers d'en-tête. - Ouvrez le projet dans Android Studio. Le code d'exemple se trouve dans
DashFunAsrFileTranscriberActivity.java. Remplacez la clé API, puis testez la fonctionnalité.
Procédure d'appel
- Mode synchrone
- Mode asynchrone
- Initialiser le SDK.
- Configurez les paramètres requis par votre activité.
- Définissez
async_requestsurfalseet appelezstartFileTranscriberpour soumettre une requête de reconnaissance vocale non temps réel et attendre le résultat. - Écoutez l'événement
EVENT_FILE_TRANS_RESULTdans l'interfaceonFileTransEventCallbackpour obtenir le résultat final de la reconnaissance. - Appelez
releasepour libérer les ressources du SDK.
Paramètres de requête
Paramètres de connexion et de contrôle
Configurez ces paramètres en transmettant une chaîne JSON dans l'argument parameters de l'interface initialize.
Exemple de paramètre
La chaîne JSON suivante est un exemple et ne répertorie pas tous les paramètres. Ajoutez les paramètres dont vous avez besoin lors de l'écriture de votre code :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
url | String | Oui | Points de terminaison de service :
{WorkspaceId} par votre véritable ID d'espace de travail. |
apikey | String | Oui | La clé API. |
service_mode | String | Oui | Le mode d'exécution. Fixé à "1" pour la reconnaissance de la parole enregistrée. |
device_id | String | Oui | Une chaîne unique qui identifie l'utilisateur final. Définissez-la sur un identifiant d'utilisateur dans l'application ou un identifiant d'appareil généré par le client. Cet identifiant est principalement utilisé pour le suivi des journaux et le dépannage. |
debug_path | String | Non | Le chemin de stockage du fichier journal.Ce paramètre prend effet uniquement lorsque save_log est défini sur true dans l'interface initialize. Dans ce cas, vous devez définir le chemin du fichier journal, sinon une erreur est signalée.Au maximum deux fichiers journaux sont conservés localement. |
max_log_file_size | int | Non | La taille maximale du fichier journal, en octets.Ce paramètre prend effet uniquement lorsque save_log est défini sur true dans l'interface initialize.Par défaut : 104857600 (100 * 1024 * 1024 octets, soit 100 Mio). |
log_track_level | int | Non | Le niveau de filtrage pour le contenu du journal envoyé via le rappel de journal (onFileTransLogTrackCallback).Par défaut : 2.Valeurs valides :
log_track_level et level (définis via l'interface initialize) déterminent ensemble quels journaux sont finalement envoyés au rappel. Un journal est envoyé au rappel uniquement lorsque sa valeur de niveau est supérieure ou égale à la fois à log_track_level et level. Par exemple, si log_track_level est défini sur 2 (INFO) et level sur 3 (WARNING), seuls les journaux de niveau WARNING ou supérieur (valeur >= 3) sont envoyés au rappel. |
Paramètres de reconnaissance vocale
Configurez tous les paramètres de reconnaissance vocale via l'interface startFileTranscriber.
Exemple de paramètre
La chaîne JSON suivante est un exemple et ne répertorie pas tous les paramètres. Ajoutez les paramètres dont vous avez besoin lors de l'écriture de votre code :
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
file_urls | array[string] | Oui | Une liste d'URL des fichiers audio ou vidéo à transcrire. HTTP et HTTPS sont pris en charge. Une seule requête ne prend en charge qu'une seule URL. Pour les exigences d'entrée telles que les formats audio pris en charge, les limites de taille de fichier et les limites de durée, consultez Spécifications audio.Si l'enregistrement est stocké dans Alibaba Cloud OSS, l'API RESTful prend en charge les URL temporaires préfixées par oss://, tandis que le SDK ne prend pas en charge les URL temporaires préfixées par oss://. |
async_request | boolean | Non | Indique si la requête de reconnaissance est asynchrone.Par défaut : false.Valeurs valides :
|
apikey | string | Non | Si la apikey dans Paramètres de connexion et de contrôle est une clé API temporaire, vous pouvez la mettre à jour ici pour éviter l'expiration. |
nls_config | object | Oui | L'objet de configuration principal pour la reconnaissance vocale. Il contient des paramètres clés tels que la sélection du modèle et le contrôle de la reconnaissance. |
nls_config.model | string | Oui | Le nom du modèle. |
nls_config.special_word_filter | object | Non | Les mots sensibles à traiter lors de la reconnaissance vocale. Vous pouvez définir une méthode de traitement différente pour chaque mot sensible. Pour plus de détails, consultez Filtrage des mots sensibles. |
nls_config.channel_id | array[integer] | Non | L'index des pistes audio à reconnaître dans un fichier audio multipiste. L'index commence à 0. Par exemple, [0] reconnaît la première piste, et [0, 1] reconnaît la première et la deuxième piste en même temps. Si vous omettez ce paramètre, seule la première piste est traitée.Valeur par défaut : [0]. |
nls_config.diarization_enabled | boolean | Non | Indique s'il faut activer la diarisation des locuteurs. Désactivé par défaut.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 la reconnaissance inclut un champ speaker_id qui distingue les différents locuteurs.Lorsque la diarisation des locuteurs est activée, maintenez la durée de l'audio dans la limite de 2 heures. Sinon, la reconnaissance peut échouer ou expirer. speaker_id, consultez la Description du résultat de la reconnaissance. |
nls_config.speaker_count | integer | Non | Une valeur de référence pour le nombre de locuteurs. La plage valide est un entier de 2 à 100 (inclus).Par défaut, le nombre de locuteurs est détecté automatiquement. Si vous définissez cette valeur, elle guide uniquement l'algorithme pour qu'il produise le nombre spécifié lorsque cela est possible, sans garantir ce nombre exact.Aucune valeur par défaut. |
nls_config.vocabulary_id | string | Non | L'ID d'une liste de mots clés précompilée.Générez cet ID à l'avance en appelant l'API de création de liste de mots clés. Transmettez l'ID lors de la reconnaissance pour utiliser les mots clés de la liste.Convient aux scénarios où le vocabulaire est connu et relativement stable, et où vous devez réutiliser la même liste de mots d'une requête à l'autre.Pour plus de détails sur l'utilisation, consultez Mots clés précompilés. |
nls_config.instant_vocabulary | object | Non | Mots-clés instantanés. Transmettez des paires clé-valeur dont les clés sont les mots-clés (string) et les valeurs sont des poids entiers (integer). Aucune liste précompilée n’est nécessaire.Pour leur utilisation, consultez Mots-clés instantanés. |
nls_config.language_hints | array[string] | Non | Les codes de langue à reconnaître. Si vous ne pouvez pas déterminer la langue à l'avance, laissez-le non défini et le modèle détectera la langue automatiquement.Vous pouvez définir jusqu’à 1 valeur. Au-delà, seules les 1 premières sont prises en compte.
Cliquez pour afficher les codes de langue pris en charge
|
Interfaces clés
NativeNui
initialize
Initialiser l'instance du SDK de reconnaissance vocale. Le SDK est un singleton. Ne pas l'initialiser à nouveau avant d'appeler release.
Cette interface est bloquante, appelez-la donc sur un thread non UI.
Signature de la méthode
| Paramètre | Type | Description |
|---|---|---|
callback | INativeFileTransCallback | L'implémentation de l'interface de rappel des événements et des données. |
parameters | String | Une chaîne JSON qui contient les paramètres d'authentification, de connexion et de débogage. Consultez Paramètres de connexion et de contrôle. |
level | Constants.LogLevel | Contrôle le niveau d'impression des propres journaux du SDK. |
save_log | boolean | Indique s'il faut enregistrer les journaux localement. Si true, spécifiez le chemin avec debug_path dans Paramètres de connexion et de contrôle, et définissez éventuellement la taille du fichier avec max_log_file_size. |
setParams
Utilisez cette interface pour définir ou mettre à jour les paramètres nls_config séparément. Si vous fournissez tous les paramètres à la fois dans startFileTranscriber, vous n'avez pas besoin d'appeler cette méthode.
Signature de la méthode
| Paramètre | Type | Description |
|---|---|---|
params | String | Le paramètre nls_config dans Paramètres de reconnaissance vocale. Les paramètres autres que nls_config ne peuvent pas être définis via cette méthode.Exemple : |
startFileTranscriber
Démarre la reconnaissance.
Signature de la méthode
| Paramètre | Type | Description |
|---|---|---|
params | String | Paramètres de reconnaissance vocale.Exemple : |
task_id | byte[] | L'ID de la tâche. Le SDK génère une chaîne aléatoire en interne. Vous obtenez l'task_id après le retour réussi de cette interface. |
queryFileTranscriber
Utilisez cette interface pour interroger l'état et le résultat actuels d'une tâche asynchrone. Une fois l'appel réussi, le résultat est renvoyé via l'événement EVENT_FILE_TRANS_QUERY_RESULT dans le rappel onFileTransEventCallback.
Obtenez l'
task_id transmis à cette méthode à partir de l'événement EVENT_FILE_TRANS_UPLOADED.| Paramètre | Type | Description |
|---|---|---|
task_id | String | L'ID de la tâche à interroger, obtenu à partir de l'événement EVENT_FILE_TRANS_UPLOADED. |
cancelFileTranscriber
Annule immédiatement la tâche en cours.
Signature de la méthode
| Paramètre | Type | Description |
|---|---|---|
task_id | String | L'ID de la tâche à annuler, obtenu à partir de l'événement EVENT_FILE_TRANS_UPLOADED. |
release
Libérer toutes les ressources internes du SDK. Après l'appel de cette méthode, l'instance du SDK devient inutilisable. Pour l'utiliser à nouveau, appeler initialize pour l'initialiser à nouveau.
Signature de la méthode
GetVersion
Obtient les informations de version actuelles du SDK.
Signature de la méthode
INativeFileTransCallback : rappels de l'écouteur
onFileTransEventCallback : écouter les événements et les résultats de reconnaissance
Signature de la méthode
| Paramètre | Type | Description |
|---|---|---|
event | NuiEvent | L'événement de rappel. |
resultCode | int | Valide uniquement lorsque l’événement EVENT_ASR_ERROR se produit. |
asrResult | AsrResult | Le résultat de la reconnaissance vocale. |
taskId | String | L'ID de la tâche. |
arg2 | int | Un paramètre réservé. |
onFileTransLogTrackCallback : écouter les journaux de trace
Ce rappel reçoit les journaux internes détaillés du SDK pour le diagnostic et le débogage des problèmes.
NuiEvent : types d'événements
| Événement | Description |
|---|---|
EVENT_FILE_TRANS_CONNECTED | La connexion au service a réussi. |
EVENT_FILE_TRANS_UPLOADED | Le fichier audio à reconnaître a été téléchargé avec succès. Vous pouvez maintenant obtenir l'task_id de la tâche en cours. |
EVENT_FILE_TRANS_QUERY_RESULT | Une requête de résultat de tâche. |
EVENT_FILE_TRANS_RESULT | Le résultat final de la reconnaissance. |
EVENT_ASR_ERROR | Une erreur s'est produite lors de la reconnaissance vocale. |