La synthèse vocale ne marche pas sur votre site : les causes, dans l'ordre
Le lecteur ne s'affiche pas, l'audio ne démarre pas, ou le son est mauvais. Trois symptômes très différents, huit causes possibles, et l'ordre dans lequel les éliminer sans y passer la journée.
« La synthèse vocale ne marche pas » recouvre trois pannes qui n'ont rien à voir entre elles, et c'est la première raison pour laquelle on perd du temps à les résoudre. Avant de chercher, décidez laquelle vous avez.
Le lecteur ne s'affiche pas du tout sur la page. Le lecteur s'affiche mais l'audio ne démarre pas. L'audio démarre mais le résultat est mauvais, mauvaise prononciation, texte tronqué, voix inattendue.
Ce sont trois enquêtes distinctes. Voici les trois, dans l'ordre où les causes se présentent réellement.
Cas 1, Le lecteur ne s'affiche pas
L'article n'a pas encore d'audio. C'est la cause la plus fréquente et la moins soupçonnée. La plupart des solutions n'affichent le lecteur que lorsqu'un fichier existe, ce qui est le bon comportement, un lecteur vide est pire qu'aucun lecteur. Vérifiez dans votre espace d'administration que l'article figure bien parmi les contenus traités. S'il vient d'être publié, la génération peut être encore en cours.
L'article n'est pas reconnu. Le lecteur doit associer la page à son fichier audio, généralement par l'adresse canonique de l'article. Si cette adresse change entre le moment de la génération et l'affichage (passage de http à https, ajout ou retrait du www, paramètres de suivi ajoutés à l'URL, environnement de préproduction qui répond sur un autre domaine) l'association échoue silencieusement. C'est de loin la cause la plus fréquente des lecteurs invisibles en préproduction alors que tout fonctionne en production.
Le script est bloqué. Ouvrez la console de votre navigateur. Une extension de blocage, une politique de sécurité de contenu (Content-Security-Policy) restrictive ou un cache agressif peuvent empêcher le chargement. La console le dit explicitement, en une ligne.
Le gabarit ne contient pas l'emplacement. Si vous avez ajouté le lecteur via un thème ou un module, vérifiez que le gabarit utilisé par ce type d'article contient bien l'appel. Les sites ont souvent plusieurs gabarits d'article et un seul a été modifié.
Cas 2, Le lecteur s'affiche mais rien ne démarre
Le fichier est protégé. Si vos articles sont réservés aux inscrits ou aux abonnés, le fichier audio l'est aussi, et il n'est servi que par un lien signé à durée limitée. Un lien expiré, ou un visiteur non connecté, donne exactement ce symptôme. Rechargez la page connecté à un compte ayant les droits.
Le navigateur refuse la lecture automatique. Aucun navigateur ne laisse démarrer un son sans action de l'utilisateur. Si vous testez une lecture déclenchée automatiquement, ce n'est pas une panne, c'est une règle.
Le format n'est pas accepté. Rare aujourd'hui, mais réel sur les navigateurs anciens et certains navigateurs intégrés à des applications. Testez la même page dans un autre navigateur : si ça marche ailleurs, vous tenez votre réponse.
Le serveur ne répond pas correctement aux requêtes partielles. Un fichier audio se lit par morceaux. Un hébergement qui ne gère pas les requêtes de plage (Range) laisse le lecteur bloqué au premier octet. Le symptôme typique : la barre de progression reste à zéro sans message d'erreur.
Cas 3, L'audio démarre mais le résultat n'est pas bon
Mauvaise prononciation des noms propres. Ce n'est pas un défaut de la voix et cela ne se corrige pas en changeant de voix. Cela se corrige avec un lexique de prononciation : une liste de mots et de leur prononciation attendue, appliquée à chaque génération. Une fois l'entrée ajoutée, elle vaut pour tous vos articles, passés et à venir.
Le texte lu ne correspond pas à l'article. Signe que l'extraction du contenu a pris la mauvaise partie de la page : un chapô répété, un encadré publicitaire, une légende d'image, ou au contraire un article tronqué à la moitié. C'est un réglage d'extraction, pas un problème de voix.
L'audio est celui d'une version précédente. Vous avez corrigé l'article mais le fichier date d'avant. Selon la configuration, la regénération est automatique à la mise à jour ou manuelle. Vérifiez lequel des deux, puis relancez.
La voix n'est pas celle attendue. Une règle de voix par rubrique, un réglage propre à un utilisateur, ou une voix retirée du catalogue et remplacée par un repli. Regardez le réglage au niveau de la rubrique avant celui du compte : c'est presque toujours là.
La méthode, si vous ne savez pas par où commencer
Trois vérifications éliminent la moitié des cas en deux minutes.
Comparez d'abord un article qui fonctionne avec celui qui ne fonctionne pas : la différence entre les deux est votre cause. Puis ouvrez la console du navigateur, qui nomme la panne quand elle est technique. Enfin, ouvrez l'adresse du fichier audio directement dans un onglet : s'il se lit là et pas dans la page, le problème est dans la page ; s'il ne se lit pas non plus, le problème est en amont.
Chez nous
WeDispatch expose une page de statut publique et une vérification de santé permanente, pour que la question « est-ce que c'est vous ou est-ce que c'est moi ? » se règle en un coup d'œil. Le lecteur est rendu côté serveur sur votre propre domaine, ce qui écarte d'emblée les pannes liées aux iframes tierces, et la correction ciblée permet de reprendre un passage sans regénérer l'article entier.
Si vous en êtes encore au choix de la solution, comment évaluer une voix neuronale traite des critères qui évitent une partie de ces problèmes en amont. Et vous pouvez tester sur un de vos articles sans rien installer.
Sonorisez vos articles avec WeDispatch
Ce blog sera lui-même sonorisé par WeDispatch. Envie de voir ce que ça donne sur vos contenus ?
Demandez une démo