P2P LiveFree live streaming · peer-to-peer delivery

Aprender

Como funciona este sistema e como o configurar — sem precisar de conhecimentos prévios.

Como funciona a transmissão ponto a ponto

Um servidor, muitos espetadores

Sem o modo ponto a ponto, cada espetador descarrega cada segundo de vídeo do seu servidor de origem. Dez espetadores significam dez vezes a largura de banda. Mil espetadores, mil vezes.

O vídeo chega aos pedaços

Uma emissão HLS é uma lista de ficheiros pequenos, de poucos segundos cada. Como todos os espetadores querem os mesmos ficheiros pela mesma ordem, quem já tem um pode dá-lo a quem não tem.

Os espetadores ajudam-se uns aos outros

Com o modo ponto a ponto, o primeiro espetador obtém um pedaço de vídeo da origem e passa-o diretamente aos outros, de navegador para navegador. A origem envia cada pedaço muito menos vezes.

Um espetador lidera

O enxame escolhe um espetador como líder. O líder fica ligeiramente à frente, descarrega da origem e alimenta os restantes. Se fechar o separador, outro assume em muito menos de um segundo.

Nada depende nunca de um par

Se um pedaço não chegar a tempo de outro espetador, o navegador vai simplesmente buscá-lo à origem. O modo ponto a ponto só pode tornar a entrega mais barata, nunca menos fiável.

Primeiros passos

Para começar precisa de uma única coisa: o endereço web de uma lista de reprodução HLS. Termina em .m3u8 e tem de estar acessível a partir da internet. Tudo o que se segue explica como obter esse endereço, consoante o que tem hoje.

Se já tem um endereço HLS

  1. Inicie sessão e abra O meu canal.
  2. Cole o endereço em Endereço da emissão HLS (.m3u8). Tem de começar por http:// ou https://.
  3. Dê um título ao canal e prima Guardar.
  4. Prima Verificar a emissão agora. Em poucos segundos o estado passa a EM LINHA.
  5. Abra a página do seu canal e inicie a reprodução. Depois abra a mesma página num segundo navegador — é nesse momento que o peer-to-peer começa, porque são precisos dois espectadores para haver alguém com quem partilhar.

Se a verificação disser que a emissão não está acessível, a causa é quase sempre uma de duas: o endereço não está acessível a partir de fora da sua própria rede, ou a origem não envia o cabeçalho Access-Control-Allow-Origin. Sem ele, os navegadores recusam-se a reproduzir uma emissão vinda de outro servidor.

Se a sua fonte é RTMP (a maioria dos codificadores, OBS)

O seu codificador envia RTMP para um servidor, e esse servidor escreve HLS. nginx-rtmp, MediaMTX, Flussonic ou ffmpeg fazem-no todos. A versão mínima com ffmpeg, na máquina que recebe a emissão:

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

Sirva /var/www/live com qualquer servidor web, acrescente o cabeçalho CORS e use https://yourhost/live/mystream/playlist.m3u8 como endereço da emissão aqui.

-c copy significa que o vídeo não é recodificado, por isso quase não gasta CPU. Use-o sempre que o seu codificador já produza H.264 e AAC, como fazem quase todos.

Se a sua fonte é SRT

O SRT é um transporte de contribuição: leva uma emissão de servidor para servidor de forma fiável, mas nenhum navegador o consegue reproduzir. Receba-a e empacote-a da mesma maneira:

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 a sua fonte é multicast (UDP ou RTP)

Este sistema não consegue ler um endereço multicast, e nenhum navegador consegue. Não é uma função em falta — é a natureza do multicast. O multicast entrega uma única cópia de uma emissão a muitos recetores numa rede configurada para a transportar; é por isso que funciona lindamente dentro da rede de um operador e não existe de todo na internet pública. Um navegador não tem forma de se juntar a um grupo multicast.

Por isso o multicast é convertido uma vez, numa máquina dentro da rede que o recebe, e o que vai para a internet é o resultado em 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

Para RTP, use antes rtp://@239.0.0.1:1234. Se a fonte multicast for MPEG-2 ou outro codec que os navegadores não consigam reproduzir, substitua -c copy por uma codificação a sério:

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

Uma só conversão serve qualquer número de espectadores, porque a partir daí é o enxame peer-to-peer que faz a distribuição.

Se a sua fonte é uma câmara 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

O cabeçalho CORS, de uma vez por todas

Seja o que for que produza o seu HLS, o servidor web que o entrega aos espectadores tem de enviar:

Access-Control-Allow-Origin: *

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

Sem ele, a verificação da emissão indica que o CORS está em falta, e nenhum navegador reproduzirá a emissão — com ou sem peer-to-peer.

De onde vem a sua emissão

Suportado diretamente

HLS por HTTP ou HTTPS

Cole o endereço da lista de reprodução no seu painel. Não é preciso mais nada.

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

Um ficheiro gravado

Sirva-o como HLS por HTTP. Qualquer servidor web serve.

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

Tem de ser convertido antes

Multicast (UDP ou RTP)

Os navegadores não podem juntar-se a um grupo multicast, por isso este servidor também não o consegue ler. Converta-o antes para HLS na sua própria rede.

udp://@239.0.0.1:1234 → HLS

SRT

Um transporte de contribuição. Receba-o num servidor, empacote-o como HLS e aponte este sistema para essa lista de reprodução.

srt://host:9000 → HLS

RTMP

Envie-o para um servidor que produza HLS e use aqui o endereço dessa lista de reprodução.

rtmp://host/app/key → HLS

RTSP (câmaras)

Típico das câmaras IP. Converta para HLS com ffmpeg ou um servidor de média e use depois esse endereço.

rtsp://camera/stream → HLS

Porque existe esta distinção

Tudo o que um espectador reproduz é obtido pelo seu navegador, por HTTP, como um ficheiro com um URL. É essa toda a base da parte peer-to-peer: dois espectadores só podem partilhar um pedaço de vídeo se ambos o puderem nomear da mesma maneira. Um URL é esse nome.

Multicast, SRT, RTMP e RTSP são todos transportes — levam uma emissão de uma máquina para outra. Nenhum deles produz ficheiros endereçáveis, e nenhum navegador fala qualquer um deles. É por isso que são convertidos primeiro, e é por isso que a conversão acontece uma vez e não por espectador.

Escolher a duração dos segmentos

-hls_time define a duração de cada pedaço. É a única definição em que vale a pena pensar:

  • 2 segundos — menor latência, mais pedidos, menos tempo para um par partilhar um pedaço antes de ser necessário.
  • 4 segundos — um bom valor predefinido, e o que os exemplos acima usam.
  • 6 segundos ou mais — a maior probabilidade de o peer-to-peer funcionar bem, à custa da latência.

O peer-to-peer funciona melhor com segmentos mais longos, porque há mais tempo para um espectador passar um pedaço a outro antes de a reprodução precisar dele. Se não tiver um requisito rígido de latência, quatro segundos são um ponto de partida sensato.

Manter os URL dos segmentos estáveis

Dois espectadores só partilham um pedaço de vídeo quando ambos pedem o mesmo URL. Se a sua CDN der a cada espectador um endereço diferente para o mesmo segmento — um token por espectador, um nome de anfitrião por servidor —, então nunca há dois espectadores a reconhecer um pedaço como o mesmo pedaço, e o enxame não entrega nada. A verificação da emissão avisa disso quando o consegue detetar.

Monitorizar a sua emissão

O que significa o alívio da origem

É a proporção de vídeo que os seus espetadores entregaram uns aos outros. Com dois ou três espetadores costuma ser pequena; com dezenas, ultrapassa muitas vezes metade.

Na página do seu canal

A linha de estado por baixo do leitor diz-lhe o que está a acontecer, em palavras simples: se o peer-to-peer está ativo, se é o único espectador e se há algum problema com a reprodução. Se disser que a emissão não está acessível, também mostra o motivo.

No seu painel

Verificar a emissão agora executa a verificação da emissão de imediato: obtém a sua lista de reprodução tal como um navegador faria e indica se está acessível, se o CORS está definido e o que encontrou lá dentro.

Como é quando tudo corre bem

  • Dois espectadores — o peer-to-peer liga-se, mas o alívio da origem mantém-se baixo. Um espectador tem de obter da origem para que o outro tenha alguma coisa para receber.
  • Dez espectadores — o alívio da origem chega muitas vezes a entre um terço e metade.
  • Dezenas de espectadores — um alívio da origem acima de metade é normal, e o tráfego da origem deixa de crescer ao mesmo ritmo que a sua audiência. É exatamente esse o objetivo.

Um alívio da origem de zero com vários espectadores a ver merece investigação: normalmente significa que os espectadores não se conseguem alcançar uns aos outros, o que um relé TURN resolve. As redes móveis são o caso mais comum.

Se os espectadores comunicarem erros

A página Análise em direto do administrador lista os erros comunicados pelos espectadores, por emissão, incluindo o protocolo HTTP que o pedido falhado usou. Uma emissão que reproduz bem a partir da sua própria máquina mas falha para espectadores noutros sítios tem normalmente um problema de CDN ou de geografia, e não uma falha na emissão — e é essa coluna que permite distinguir os dois casos.

Glossário

HLS
HTTP Live Streaming. Uma forma de enviar vídeo como uma lista de ficheiros pequenos que qualquer navegador pode descarregar por HTTP normal.
Lista de reprodução (.m3u8)
O ficheiro de texto que enumera por ordem os pedaços da sua emissão. É este o endereço que cola no seu painel.
Segmento
Um ficheiro pequeno de vídeo, normalmente de 2 a 6 segundos. É o que os espetadores partilham entre si.
Origem
O servidor de onde a sua emissão vem realmente: o seu codificador, empacotador ou CDN. O modo ponto a ponto reduz quanto ele tem de enviar.
Enxame
Todos os que veem a mesma emissão ao mesmo tempo. Trocam segmentos entre si.
Líder
O espetador que o enxame escolheu para descarregar da origem e alimentar os outros.
Par
Outro espetador ao qual o seu navegador está ligado diretamente.
WebRTC
A tecnologia do navegador que permite a dois espetadores trocarem dados sem passarem por um servidor.
STUN
Um pequeno serviço que diz a um navegador como o seu próprio endereço é visto do exterior, para que dois espetadores se consigam encontrar.
TURN
Um retransmissor usado quando dois espetadores não se conseguem alcançar diretamente, o que é comum em redes móveis. Este servidor pode alojar um.
Alívio da origem
A proporção de vídeo entregue pelos espetadores em vez da sua origem. Quanto maior, mais barato.
CORS
Uma regra que permite a uma página web ler ficheiros de outro servidor. A sua origem tem de o permitir, ou os navegadores recusam reproduzir a emissão.
Multicast
Uma forma de enviar uma única cópia de uma emissão a muitos recetores numa rede gerida. Os navegadores não a conseguem receber, por isso tem de ser convertida antes para HLS.
SRT
Um transporte para mover uma emissão de forma fiável entre servidores pela internet. É um formato de contribuição, não algo que um navegador consiga reproduzir.
RTMP
Um protocolo mais antigo, ainda muito usado para enviar uma emissão de um codificador para um servidor. Os navegadores não o reproduzem diretamente.
Transcodificar
Voltar a codificar o vídeo noutro formato ou qualidade. Necessário quando a sua fonte não é já algo que os navegadores consigam reproduzir.
Empacotar
Cortar uma emissão recebida em segmentos HLS e escrever a lista de reprodução, sem ter necessariamente de recodificar o vídeo.