Structure d’un fichier M3U8 : diagnostiquer les erreurs via les balises

Guide pratique des balises M3U8 pour résoudre les échecs de lecture, le buffering et le changement de qualité.

Équipe M3U8Online

Quand la vidéo ne se lance pas ou que le changement de qualité échoue, il faut d’abord lire le fichier M3U8.

Structure type

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:120

#EXTINF:6.0,
seg120.ts
#EXTINF:6.0,
seg121.ts
#EXTINF:6.0,
seg122.ts

#EXT-X-ENDLIST

Balises essentielles

#EXTM3U

En-tête du fichier. Sans lui, le lecteur peut refuser la playlist.

#EXT-X-TARGETDURATION

Durée maximale d’un segment. Trop élevée = latence au démarrage, trop basse = plus de requêtes.

#EXT-X-MEDIA-SEQUENCE

Numéro de segment de départ. En live, cette valeur augmente en continu.

#EXTINF

Durée d’un segment. Une mauvaise valeur peut casser la timeline.

#EXT-X-ENDLIST

Indique la fin VOD. Généralement absent en direct.

Checklist rapide

  1. Présence de #EXTM3U
  2. URLs de segments accessibles
  3. Durées #EXTINF cohérentes
  4. Sous-playlists en HTTP 200
  5. Vérification CORS

Liens utiles