Dépannage

Cette page regroupe les erreurs courantes et les codes d’erreur du SDK, ainsi que des liens utiles.

Erreurs courantes

Microphone refusé

• Code : microphone_denied
• Cause : l’utilisateur a refusé l’accès au micro ou le navigateur bloque l’accès.
• Solution : demander à l’utilisateur d’autoriser le micro dans les paramètres du site/navigateur et de recharger la page si besoin.

Contexte non sécurisé

• Code : insecure_context
• Cause : la page n’est pas servie en HTTPS (sauf sur localhost).
• Solution : utiliser HTTPS en production. Les API microphone et AudioWorklet exigent un contexte sécurisé hors localhost.

Erreur audio worklet

• Code : audio_worklet_error
• Cause : le fichier audio-processor.js n’a pas été chargé (URL incorrecte, fichier absent ou CORS).
• Solution : s’assurer que audio-processor.js est bien servi (par ex. dans public/) et que l’URL correspond à la prop audioProcessorUrl (défaut : /audio-processor.js). Utiliser npx create-ephia-transcribe@latest pour copier le fichier dans un projet existant.

WebSocket

• Codes : websocket_error, websocket_auth_error
• Cause : impossibilité de se connecter au serveur de streaming, ou token invalide/expiré.
• Solution : vérifier l’URL de streaming (streamingUrl ou streamingUrlBase), la connectivité réseau et la validité du token. Obtenir une clé API valide : Créer votre clé API.

Token manquant

• Code : token_missing
• Cause : la prop token du TranscriptionButton est vide ou non fournie.
• Solution : fournir une clé API valide via la prop token.

Codes d’erreur (résumé)

Liens utiles

• Créer votre clé API
• Installation — notamment la présence de audio-processor.js et l’import des styles
• Utilisation — construction de l’URL et état exposé