Pourquoi un lien M3U8 échoue
| Cause | A quoi ça ressemble | Quoi essayer |
|---|---|---|
| Bloc CORS | Les segments manifeste ou .ts se chargent au VLC mais échouent dans le navigateur. | Activez le proxy intelligent CORS et exécutez à nouveau le rapport de santé. |
| Expiré URL | Le manifeste renvoie 403, 404 ou une réponse vide partout. | Capturez un nouveau .m3u8 URL à partir de la page source ou CDN. |
| Protection des liens hypertextes | Le flux ne fonctionne que lorsque les demandes proviennent du site Web d'origine. | Définissez les mêmes Referer et, si nécessaire, User-Agent dans les options de proxy. |
| Segment mort | Le manifeste se charge, mais la lecture s'arrête ou saute après quelques secondes. | Exécutez le validateur M3U8 et inspectez les échecs de segments échantillonnés. |
| Codec non pris en charge | VLC lit le flux, mais le navigateur affiche uniquement de l'audio ou une vidéo noire. | Vérifiez les codecs dans le rapport de santé et essayez un autre navigateur ou VLC. |
| Contenu mixte | Une page HTTPS tente de charger un flux HTTP. | Utilisez un flux HTTPS URL ou acheminez le flux via un point de terminaison proxy. |
| DRM | Le manifeste indique une lecture protégée avec Widevine, FairPlay ou PlayReady. | Utilisez l'application ou le lecteur sous licence. Cet outil ne contourne pas les DRM. |
Comment réparer un lien M3U8 qui ne sera pas lu
- 1
Confirmez que le manifeste est réel
Ouvrez le M3U8URL directement ou collez-le dans le lecteur. Un manifeste HLS valide commence généralement par #EXTM3U et contient des balises telles que #EXT-X-STREAM-INF, #EXTINF ou #EXT-X-ENDLIST.
- 2
Essayez d'abord la lecture sans proxy
Collez le URL et appuyez sur Play. S'il se charge, le flux est accessible et vous pouvez continuer à tester le débit, les sous-titres, la conversion ou l'édition de la playlist.
- 3
Activer le proxy CORS
Si le navigateur signale une erreur CORS ou si le flux fonctionne dans VLC mais pas en ligne, activez le proxy intelligent CORS afin que les manifestes, les clés et les segments soient demandés via le proxy.
- 4
Réglez les Referer et User-Agent si nécessaire
Pour les flux protégés par hotlink, copiez la page URL où le flux est normalement lu et définissez-la comme Referer. Ajoutez un navigateur de bureau User-Agent si l'origine filtre par client.
- 5
Exécuter le rapport de santé
Utilisez le validateur M3U8 pour répertorier les pistes, le débit binaire, le cryptage, l'état en direct/VOD et les segments .ts morts échantillonnés. Cela sépare un véritable lien mort d’un problème d’accès au navigateur.
- 6
Vérifiez les limites du codec et du DRM
Si le manifeste et les segments sont accessibles mais que la lecture échoue toujours, inspectez les codecs et le cryptage. Les lecteurs de navigateur ne peuvent pas décoder tous les codecs et cet outil ne contourne pas les DRM.
Comment savoir s'il s'agit du CORS ou d'un lien mort
Le CORS est une règle de navigateur, donc le même flux peut échouer en ligne et toujours jouer au VLC. Un lien mort échoue partout. Si le VLC ouvre le URL mais que le navigateur ne le fait pas, commencez par le proxy. Si les deux échouent, inspectez l’état HTTP et capturez un nouveau URL car les liens HLS signés expirent souvent rapidement.
Lorsqu'un Referer personnalisé corrige la lecture
Certaines origines ne servent les manifestes et les segments que lorsque la demande semble provenir de la page d'origine. C'est la protection des liens hypertextes. Dans ce lecteur, activez le proxy, ouvrez les options avancées, définissez la page d'origine sur Referer et réessayez. Si l'origine vérifie également le type de client, ajoutez un navigateur User-Agent.
Pourquoi la lecture démarre puis s'arrête
Un manifeste peut être valide lorsqu'un ou plusieurs segments multimédias sont disparus, bloqués ou surchargés. Le lecteur peut démarrer, tamponner, puis s'arrêter lorsqu'il atteint le segment cassé. Le rapport d'intégrité échantillonne le segment .ts URLs via le proxy et rapporte le nombre de réussites/échecs afin que vous sachiez si le chemin CDN est réellement sain.
Pourquoi VLC et un navigateur ne sont pas d'accord
Le VLC n'est pas lié par les règles CORS du navigateur et prend en charge davantage de codecs, il peut donc lire les flux qu'un navigateur rejette. Un outil de navigateur est meilleur pour le débogage Web car il fait apparaître les mêmes problèmes CORS, de contenu mixte et d'en-tête que les visiteurs de votre site Web rencontreront, puis vous donne des contrôles proxy et Referer pour tester les correctifs.
Des outils qui aident à isoler le problème
- M3U8 Validateur vérifie les pistes, le débit binaire, le cryptage, l'état live/VOD et les segments morts.
- M3U8 à MP4 confirme si les segments accessibles peuvent être remuxés dans un fichier.
- VLC vs En ligne M3U8 Player explique pourquoi la lecture sur le navigateur et sur le bureau ne concorde pas toujours.
Questions fréquemment posées
Pourquoi mon lien M3U8 n'est-il pas lu dans le navigateur ?
Les causes les plus courantes sont les restrictions CORS, un URL signé expiré, une protection hotlink qui nécessite un Referer spécifique, des segments .ts morts, des codecs non pris en charge, un contenu HTTP/HTTPS mixte ou un DRM. Essayez d'abord le proxy et le rapport d'intégrité pour séparer les problèmes d'accès au navigateur d'un flux interrompu.
Pourquoi le même M3U8URL fonctionne-t-il dans le VLC mais pas en ligne ?
Le VLC n'est pas limité par les règles CORS du navigateur, il peut donc récupérer des flux auxquels un joueur en ligne ne peut pas accéder directement. Activez le proxy CORS dans le lecteur du navigateur, puis réessayez avec un Referer personnalisé si l'origine utilise la protection hotlink.
Comment corriger une erreur HLS CORS ?
Utilisez une origine qui envoie les en-têtes Access-Control-Allow-Origin corrects, ou acheminez le manifeste, les clés et les segments via un proxy CORS. Pour les tests, activez le proxy intelligent dans ce lecteur et exécutez le rapport de santé via celui-ci.
Quel Referer dois-je utiliser pour un flux M3U8 protégé ?
Utilisez le URL de la page où le flux est normalement lu, et non le .m3u8 URL lui-même. De nombreuses origines vérifient cette page en tant que Referer avant de diffuser les segments manifestes ou multimédias.
Cela peut-il réparer les flux protégés par DRM ?
Non. Cet outil peut aider au débogage des CORS, Referer et des segments morts, mais il ne contourne pas les systèmes DRM tels que Widevine, FairPlay ou PlayReady.