HLS en HTTP ou HTTPS
Collez l'adresse de la playlist dans votre tableau de bord. Rien d'autre n'est nécessaire.
https://origin.example.com/live/stream/playlist.m3u8
Comment ce système fonctionne et comment le configurer — aucune connaissance préalable requise.
Sans pair-à-pair, chaque spectateur télécharge chaque seconde de vidéo depuis votre serveur d'origine. Dix spectateurs, c'est dix fois la bande passante. Mille spectateurs, mille fois.
Un flux HLS est une liste de petits fichiers de quelques secondes. Comme tous les spectateurs veulent les mêmes fichiers dans le même ordre, celui qui en a déjà un peut le donner à celui qui ne l'a pas.
Avec le pair-à-pair, le premier spectateur récupère un morceau de vidéo depuis l'origine puis le transmet directement aux autres, de navigateur à navigateur. L'origine envoie chaque morceau bien moins souvent.
L'essaim choisit un spectateur comme meneur. Le meneur reste légèrement en avance, télécharge depuis l'origine et alimente les autres. S'il ferme l'onglet, un autre prend le relais en bien moins d'une seconde.
Si un morceau n'arrive pas à temps d'un autre spectateur, le navigateur va simplement le chercher à l'origine. Le pair-à-pair ne peut que réduire le coût de la diffusion, jamais sa fiabilité.
Pour commencer, il vous faut une seule chose : l’adresse web d’une playlist HLS. Elle se termine par .m3u8 et doit être accessible depuis internet. Tout ce qui suit explique comment obtenir une telle adresse, selon ce dont vous disposez aujourd’hui.
http:// ou https://.Si la vérification indique que le flux est inaccessible, la cause est presque toujours l’une de ces deux : l’adresse n’est pas accessible depuis l’extérieur de votre propre réseau, ou l’origine n’envoie pas l’en-tête Access-Control-Allow-Origin. Sans lui, les navigateurs refusent de lire un flux provenant d’un autre serveur.
Votre encodeur envoie du RTMP à un serveur, et ce serveur écrit du HLS. nginx-rtmp, MediaMTX, Flussonic ou ffmpeg savent tous le faire. La version minimale avec ffmpeg, sur la machine qui reçoit le flux :
ffmpeg -listen 1 -i rtmp://0.0.0.0:1935/live/mystream \
-c copy -f hls \
-hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
/var/www/live/mystream/playlist.m3u8
Servez /var/www/live avec n’importe quel serveur web, ajoutez l’en-tête CORS et utilisez https://yourhost/live/mystream/playlist.m3u8 comme adresse du flux ici.
-c copy signifie que la vidéo n’est pas réencodée : cela ne coûte presque aucun temps de calcul. Utilisez-le chaque fois que votre encodeur produit déjà du H.264 et de l’AAC, ce que font presque tous les encodeurs.
SRT est un transport de contribution : il achemine un flux de manière fiable entre serveurs, mais aucun navigateur ne sait le lire. Recevez-le et empaquetez-le de la même façon :
ffmpeg -i "srt://0.0.0.0:9000?mode=listener&latency=200" \
-c copy -f hls \
-hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
/var/www/live/mystream/playlist.m3u8
Ce système ne peut pas lire une adresse multicast, et aucun navigateur ne le peut non plus. Ce n’est pas une fonction manquante : c’est la nature même du multicast. Le multicast livre une seule copie d’un flux à de nombreux récepteurs sur un réseau configuré pour le transporter ; c’est pourquoi il fonctionne à merveille à l’intérieur du réseau d’un opérateur et n’existe pas du tout sur l’internet public. Un navigateur n’a aucun moyen de rejoindre un groupe multicast.
Le multicast est donc converti une seule fois, sur une machine située à l’intérieur du réseau qui le reçoit, et c’est le résultat HLS qui est mis en ligne :
ffmpeg -i "udp://@239.0.0.1:1234?fifo_size=1000000&overrun_nonfatal=1" \
-c copy -f hls \
-hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
/var/www/live/channel1/playlist.m3u8
Pour le RTP, utilisez plutôt rtp://@239.0.0.1:1234. Si la source multicast est en MPEG-2 ou dans un autre codec que les navigateurs ne savent pas lire, remplacez -c copy par un véritable encodage :
-c:v libx264 -preset veryfast -b:v 3000k -g 100 -c:a aac -b:a 128k
Une seule conversion sert un nombre quelconque de spectateurs, car à partir de là c’est l’essaim pair-à-pair qui assure la distribution.
ffmpeg -rtsp_transport tcp -i rtsp://user:password@camera.local/stream1 \
-c:v libx264 -preset veryfast -g 50 -c:a aac \
-f hls -hls_time 2 -hls_list_size 5 -hls_flags delete_segments \
/var/www/live/camera1/playlist.m3u8
Quel que soit ce qui produit votre HLS, le serveur web qui le livre aux spectateurs doit envoyer :
Access-Control-Allow-Origin: *
Dans nginx :
location /live/ {
add_header Access-Control-Allow-Origin * always;
add_header Cache-Control "no-cache" always;
types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; }
root /var/www;
}
Sans lui, la vérification du flux signale que CORS est absent, et aucun navigateur ne lira le flux — avec ou sans pair-à-pair.
Collez l'adresse de la playlist dans votre tableau de bord. Rien d'autre n'est nécessaire.
https://origin.example.com/live/stream/playlist.m3u8
Servez-le en HLS sur HTTP. N'importe quel serveur web convient.
https://files.example.com/vod/show/playlist.m3u8
Les navigateurs ne peuvent pas rejoindre un groupe multicast, donc ce serveur non plus. Convertissez-le d'abord en HLS sur votre propre réseau.
udp://@239.0.0.1:1234 → HLS
Un transport de contribution. Recevez-le sur un serveur, packagez-le en HLS, puis pointez ce système vers cette playlist.
srt://host:9000 → HLS
Envoyez-le vers un serveur qui produit du HLS, puis utilisez ici l'adresse de cette playlist.
rtmp://host/app/key → HLS
Typique des caméras IP. Convertissez en HLS avec ffmpeg ou un serveur média, puis utilisez cette adresse.
rtsp://camera/stream → HLS
Tout ce qu’un spectateur lit est récupéré par son navigateur, en HTTP, sous forme de fichier doté d’une URL. C’est tout le fondement de la partie pair-à-pair : deux spectateurs ne peuvent partager un morceau de vidéo que s’ils peuvent tous deux le nommer de la même façon. Une URL est ce nom.
Le multicast, SRT, RTMP et RTSP sont tous des transports : ils acheminent un flux d’une machine à une autre. Aucun ne produit de fichiers adressables, et aucun navigateur ne parle l’un d’eux. C’est pourquoi ils sont d’abord convertis, et pourquoi la conversion se fait une fois et non pour chaque spectateur.
-hls_time fixe la durée de chaque morceau. C’est le seul réglage qui mérite réflexion :
Le pair-à-pair fonctionne mieux avec des segments plus longs, car un spectateur a plus de temps pour transmettre un morceau à un autre avant que la lecture n’en ait besoin. Si vous n’avez pas d’exigence stricte de latence, quatre secondes sont un point de départ raisonnable.
Deux spectateurs ne partagent un morceau de vidéo que s’ils demandent tous deux la même URL. Si votre CDN donne à chaque spectateur une adresse différente pour le même segment — un jeton par spectateur, un nom d’hôte par serveur —, alors deux spectateurs ne reconnaissent jamais un morceau comme étant le même, et l’essaim ne livre rien. La vérification du flux vous en avertit lorsqu’elle peut le détecter.
C'est la part de vidéo que vos spectateurs se sont livrée entre eux. Avec deux ou trois spectateurs elle est faible ; avec des dizaines, elle dépasse souvent la moitié.
La ligne d’état sous le lecteur vous dit ce qui se passe, en termes simples : si le pair-à-pair est actif, si vous êtes le seul spectateur et si la lecture rencontre un problème. Si elle indique que le flux est inaccessible, la raison est affichée aussi.
Vérifier le flux maintenant lance immédiatement la vérification du flux : elle récupère votre playlist comme le ferait un navigateur et indique si elle est accessible, si CORS est configuré et ce qu’elle a trouvé à l’intérieur.
Un délestage nul alors que plusieurs spectateurs regardent mérite une enquête : cela signifie généralement que les spectateurs ne parviennent pas à se joindre, ce qu’un relais TURN résout. Les réseaux mobiles sont le cas le plus courant.
La page Analyse en direct de l’administrateur liste les erreurs signalées par les spectateurs, par flux, y compris le protocole HTTP utilisé par la requête en échec. Un flux qui se lit bien depuis votre propre machine mais échoue pour des spectateurs ailleurs a généralement un problème de CDN ou de géographie plutôt qu’un défaut dans le flux, et c’est cette colonne qui permet de faire la différence.