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
Como funciona este sistema e como o configurar — sem precisar de conhecimentos prévios.
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.
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.
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.
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.
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.
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.
http:// ou https://.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.
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.
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
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.
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
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.
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
Sirva-o como HLS por HTTP. Qualquer servidor web serve.
https://files.example.com/vod/show/playlist.m3u8
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
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
Envie-o para um servidor que produza HLS e use aqui o endereço dessa lista de reprodução.
rtmp://host/app/key → HLS
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
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.
-hls_time define a duração de cada pedaço. É a única definição em que vale a pena pensar:
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.
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.
É 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.
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.
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.
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.
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.