P2P LiveFree live streaming · peer-to-peer delivery

Impara

Come funziona questo sistema e come configurarlo, senza bisogno di conoscenze pregresse.

Come funziona lo streaming peer-to-peer

Un server, molti spettatori

Senza peer-to-peer ogni spettatore scarica ogni secondo di video dal suo server di origine. Dieci spettatori significano dieci volte la banda. Mille spettatori, mille volte.

Il video arriva a pezzi

Un flusso HLS è un elenco di piccoli file, di pochi secondi ciascuno. Poiché tutti gli spettatori vogliono gli stessi file nello stesso ordine, chi ne ha già uno può darlo a chi non ce l'ha.

Gli spettatori si aiutano a vicenda

Con il peer-to-peer il primo spettatore prende un pezzo di video dall'origine e lo passa direttamente agli altri, da browser a browser. L'origine invia ogni pezzo molte meno volte.

Uno spettatore guida

Lo sciame sceglie uno spettatore come leader. Il leader resta leggermente avanti, scarica dall'origine e alimenta gli altri. Se chiude la scheda, un altro subentra in molto meno di un secondo.

Nulla dipende mai da un peer

Se un pezzo non arriva in tempo da un altro spettatore, il browser lo scarica semplicemente dall'origine. Il peer-to-peer può solo rendere la consegna più economica, mai meno affidabile.

Primi passi

Per iniziare le serve una sola cosa: l’indirizzo web di una playlist HLS. Termina con .m3u8 e deve essere raggiungibile da internet. Tutto quello che segue spiega come ottenere un indirizzo del genere, a seconda di ciò che ha oggi.

Se ha già un indirizzo HLS

  1. Acceda e apra Il mio canale.
  2. Incolli l’indirizzo in Indirizzo del flusso HLS (.m3u8). Deve iniziare con http:// o https://.
  3. Dia un titolo al canale, poi prema Salva.
  4. Prema Controlla il flusso ora. Nel giro di pochi secondi lo stato diventa IN LINEA.
  5. Apra la pagina del suo canale e avvii la riproduzione. Poi apra la stessa pagina in un secondo browser: è allora che parte il peer-to-peer, perché servono due spettatori perché ci sia qualcuno con cui condividere.

Se il controllo dice che il flusso non è raggiungibile, quasi sempre la causa è una di queste due: l’indirizzo non è raggiungibile dall’esterno della sua rete, oppure l’origine non invia l’intestazione Access-Control-Allow-Origin. Senza di essa i browser si rifiutano di riprodurre un flusso proveniente da un altro server.

Se la sua sorgente è RTMP (la maggior parte degli encoder, OBS)

Il suo encoder invia RTMP a un server, e quel server scrive HLS. nginx-rtmp, MediaMTX, Flussonic o ffmpeg lo fanno tutti. La versione minima con ffmpeg, sulla macchina che riceve il flusso:

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

Pubblichi /var/www/live con un server web qualsiasi, aggiunga l’intestazione CORS e usi https://yourhost/live/mystream/playlist.m3u8 come indirizzo del flusso qui.

-c copy significa che il video non viene ricodificato, quindi non costa quasi nulla in CPU. Lo usi ogni volta che il suo encoder produce già H.264 e AAC, come fanno quasi tutti.

Se la sua sorgente è SRT

SRT è un trasporto di contribuzione: sposta un flusso tra server in modo affidabile, ma nessun browser è in grado di riprodurlo. Lo riceva e lo impacchetti allo stesso modo:

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

Se la sua sorgente è multicast (UDP o RTP)

Questo sistema non può leggere un indirizzo multicast, e nessun browser può farlo. Non è una funzione mancante: è la natura stessa del multicast. Il multicast consegna una sola copia di un flusso a molti ricevitori su una rete configurata per trasportarlo; per questo funziona benissimo all’interno della rete di un operatore e non esiste affatto sull’internet pubblico. Un browser non ha alcun modo di unirsi a un gruppo multicast.

Il multicast viene quindi convertito una volta sola, su una macchina all’interno della rete che lo riceve, e ciò che va online è il risultato HLS:

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

Per RTP usi invece rtp://@239.0.0.1:1234. Se la sorgente multicast è MPEG-2 o un altro codec che i browser non sanno riprodurre, sostituisca -c copy con una vera codifica:

-c:v libx264 -preset veryfast -b:v 3000k -g 100 -c:a aac -b:a 128k

Una sola conversione serve un numero qualsiasi di spettatori, perché da quel punto in poi è lo sciame peer-to-peer a occuparsi della distribuzione.

Se la sua sorgente è una telecamera IP (RTSP)

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

L’intestazione CORS, una volta per tutte

Qualunque cosa produca il suo HLS, il server web che lo consegna agli spettatori deve inviare:

Access-Control-Allow-Origin: *

In 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;
}

Senza di essa il controllo del flusso segnala che CORS manca, e nessun browser riprodurrà il flusso, con o senza peer-to-peer.

Da dove arriva il suo flusso

Supportato direttamente

HLS via HTTP o HTTPS

Incolli l'indirizzo della playlist nel pannello. Non serve altro.

https://origin.example.com/live/stream/playlist.m3u8

Un file registrato

Lo serva come HLS via HTTP. Va bene qualsiasi server web.

https://files.example.com/vod/show/playlist.m3u8

Va convertito prima

Multicast (UDP o RTP)

I browser non possono unirsi a un gruppo multicast, quindi nemmeno questo server può leggerlo. Lo converta prima in HLS sulla sua rete.

udp://@239.0.0.1:1234 → HLS

SRT

Un trasporto di contribuzione. Lo riceva su un server, lo impacchetti come HLS e punti questo sistema a quella playlist.

srt://host:9000 → HLS

RTMP

Lo invii a un server che produce HLS e usi qui l'indirizzo di quella playlist.

rtmp://host/app/key → HLS

RTSP (telecamere)

Tipico delle telecamere IP. Converta in HLS con ffmpeg o un media server, poi usi quell'indirizzo.

rtsp://camera/stream → HLS

Perché esiste questa distinzione

Tutto ciò che uno spettatore riproduce viene scaricato dal suo browser, via HTTP, come un file con un URL. È l’intera base della parte peer-to-peer: due spettatori possono condividere un pezzo di video solo se entrambi possono chiamarlo allo stesso modo. Un URL è quel nome.

Multicast, SRT, RTMP e RTSP sono tutti trasporti: spostano un flusso da una macchina all’altra. Nessuno di essi produce file indirizzabili e nessun browser parla alcuno di essi. Per questo vengono prima convertiti, e per questo la conversione avviene una volta sola e non per ogni spettatore.

Scegliere la durata dei segmenti

-hls_time stabilisce quanto dura ciascun pezzo. È l’unica impostazione su cui vale la pena riflettere:

  • 2 secondi — latenza più bassa, più richieste, meno tempo perché un peer condivida un pezzo prima che serva.
  • 4 secondi — un buon valore predefinito, ed è quello usato negli esempi sopra.
  • 6 secondi o più — le maggiori probabilità che il peer-to-peer funzioni bene, a scapito della latenza.

Il peer-to-peer funziona meglio con segmenti più lunghi, perché c’è più tempo perché uno spettatore passi un pezzo a un altro prima che la riproduzione ne abbia bisogno. Se non ha un requisito di latenza stringente, quattro secondi sono un punto di partenza sensato.

Mantenere stabili gli URL dei segmenti

Due spettatori condividono un pezzo di video solo quando entrambi richiedono lo stesso URL. Se il suo CDN dà a ogni spettatore un indirizzo diverso per lo stesso segmento — un token per spettatore, un nome host per server —, allora due spettatori non riconoscono mai un pezzo come lo stesso pezzo, e lo sciame non consegna nulla. Il controllo del flusso lo segnala quando riesce a rilevarlo.

Monitorare il flusso

Che cosa significa alleggerimento

È la quota di video che i suoi spettatori si sono consegnati a vicenda. Con due o tre spettatori è di solito piccola; con decine supera spesso la metà.

Sulla pagina del suo canale

La riga di stato sotto il player le dice cosa sta succedendo, con parole semplici: se il peer-to-peer è attivo, se lei è l’unico spettatore e se c’è qualcosa che non va nella riproduzione. Se indica che il flusso non è raggiungibile, mostra anche il motivo.

Nel suo pannello

Controlla il flusso ora esegue subito il controllo del flusso: scarica la sua playlist come farebbe un browser e riferisce se è raggiungibile, se CORS è impostato e cosa ha trovato al suo interno.

Come appare quando tutto va bene

  • Due spettatori — il peer-to-peer si collega, ma l’alleggerimento resta basso. Uno spettatore deve scaricare dall’origine perché l’altro abbia qualcosa da ricevere.
  • Dieci spettatori — l’alleggerimento raggiunge di solito tra un terzo e la metà.
  • Decine di spettatori — un alleggerimento superiore alla metà è normale, e il traffico dell’origine smette di crescere di pari passo con il suo pubblico. È proprio questo lo scopo.

Un alleggerimento pari a zero con diversi spettatori collegati merita un’indagine: di solito significa che gli spettatori non riescono a raggiungersi a vicenda, e un relay TURN lo risolve. Le reti mobili sono il caso più comune.

Se gli spettatori segnalano errori

La pagina Analisi in diretta dell’amministratore elenca gli errori segnalati dagli spettatori, per flusso, compreso il protocollo HTTP usato dalla richiesta fallita. Un flusso che si riproduce bene dalla sua macchina ma fallisce per spettatori altrove ha di solito un problema di CDN o di area geografica, non un difetto nel flusso, ed è quella colonna a distinguere i due casi.

Glossario

HLS
HTTP Live Streaming. Un modo di inviare video come elenco di piccoli file che qualsiasi browser può scaricare via HTTP normale.
Playlist (.m3u8)
Il file di testo che elenca in ordine i pezzi del suo flusso. È questo l'indirizzo che incolla nel pannello.
Segmento
Un piccolo file video, di solito da 2 a 6 secondi. È ciò che gli spettatori si scambiano.
Origine
Il server da cui il flusso proviene davvero: il suo encoder, packager o CDN. Il peer-to-peer riduce quanto deve inviare.
Sciame
Tutti quelli che guardano lo stesso flusso nello stesso momento. Si scambiano segmenti fra loro.
Leader
Lo spettatore che lo sciame ha scelto per scaricare dall'origine e alimentare gli altri.
Peer
Un altro spettatore a cui il suo browser è collegato direttamente.
WebRTC
La tecnologia del browser che permette a due spettatori di scambiarsi dati senza passare da un server.
STUN
Un piccolo servizio che dice a un browser come appare il proprio indirizzo visto dall'esterno, perché due spettatori possano trovarsi.
TURN
Un relè usato quando due spettatori non riescono a raggiungersi direttamente, cosa comune sulle reti mobili. Questo server può ospitarne uno.
Alleggerimento
La quota di video consegnata dagli spettatori anziché dalla sua origine. Più è alta, meno costa.
CORS
Una regola che consente a una pagina web di leggere file da un altro server. La sua origine deve permetterlo, altrimenti i browser rifiuteranno di riprodurre il flusso.
Multicast
Un modo di inviare una sola copia di un flusso a molti ricevitori su una rete gestita. I browser non possono riceverlo, quindi va prima convertito in HLS.
SRT
Un trasporto per spostare un flusso in modo affidabile fra server su internet. È un formato di contribuzione, non qualcosa che un browser possa riprodurre.
RTMP
Un protocollo più vecchio, ancora molto usato per mandare un flusso da un encoder a un server. I browser non lo riproducono direttamente.
Transcodificare
Ricodificare il video in un altro formato o un'altra qualità. Serve quando la sorgente non è già riproducibile dai browser.
Packaging
Tagliare un flusso in ingresso in segmenti HLS e scrivere la playlist, senza per forza ricodificare il video.