Outil gratuit par DCAST
Pourquoi ça ne se lance pas ?
Suivez cette checklist quand votre flux ou lien vidéo ne se lit pas. Testez ensuite l’URL ci-dessous ou dans le vérificateur de flux.
URL et format
Le lien est-il une URL de flux directe ? Elle doit se terminer par .m3u8 pour le HLS ou pointer vers une playlist.
Est-ce une master playlist (plusieurs #EXT-X-STREAM-INF) ou une seule media playlist ? Les deux sont valides ; certains lecteurs attendent l’une ou l’autre.
L’URL commence-t-elle par https:// ou http:// ? Certains lecteurs bloquent le contenu mixte.
URL expirée ou invalide ? Les liens et jetons de flux en direct expirent souvent.
Serveur et CORS
Si cela fonctionne dans notre lecteur mais pas dans votre application ou intégration, le problème peut venir du CORS : le serveur doit autoriser votre origine.
Essayez d’ouvrir le flux dans un nouvel onglet ou dans notre lecteur HLS pour isoler le lecteur du serveur.
Codec et lecteur
Codec audio : la plupart des navigateurs attendent de l’AAC en HLS. Si le flux utilise de l’AC-3 ou d’autres codecs, certains lecteurs ne liront pas l’audio.
Codec vidéo : le H.264 est largement pris en charge ; la prise en charge de HEVC/AV1 varie selon l’appareil et le navigateur.
Vérifiez que votre lecteur ou appareil prend en charge les codecs du flux. Utilisez le vérificateur de flux pour voir la playlist.
Direct vs VOD
Pour les flux en direct, assurez-vous que l’encodeur émet et que le flux n’est pas hors ligne.
La master playlist doit être mise à jour avec de nouveaux segments ; si le serveur est bloqué, la lecture peut se figer.
Testez votre flux
Collez l’URL de votre flux et ouvrez-la dans notre lecteur (nouvel onglet) :
Ou utilisez Stream Lab pour vérifier si l’URL est du HLS et jeter un œil à la playlist. Pour une validation complète selon la spécification, utilisez HLS Report (externe).
Expliquer cette erreur
Collez un message d’erreur ou un extrait de playlist pour une courte explication et l’étape suivante.
À propos de cette checklist de lecture
Cette checklist couvre les raisons les plus fréquentes pour lesquelles un lien HLS ou M3U8 ne se lit pas : format d’URL incorrect, CORS, prise en charge du codec ou liens expirés. Parcourez chaque section, puis testez votre URL dans le lecteur HLS ou le Stream Lab. Pour une validation complète de la playlist, utilisez des outils externes comme HLS Report.
- Q:Mon flux fonctionne dans le lecteur HLS mais pas dans mon application. Pourquoi ?
- A:Souvent, le serveur autorise ce site (CORS) mais pas l’origine de votre application. Demandez à votre hébergeur de flux d’ajouter votre domaine aux origines CORS autorisées, ou utilisez un proxy qui ajoute les bons en-têtes.
- Q:Que faire si l’URL renvoie une erreur 404 ou expire ?
- A:Les URL et jetons de flux en direct expirent souvent. Générez un nouveau lien depuis votre plateforme de streaming ou votre CDN. Pour la VOD, vérifiez que le chemin et le jeton sont toujours valides.