Problemas comuns com entrada HTTP/HLS

Códigos HTTP comuns

Os códigos de resposta HTTP são indicadores numéricos de três dígitos que o servidor envia em resposta à requisição HTTP de um cliente.

Quando a requisição é bem-sucedida, o servidor retorna o código 200 e o conteúdo da resposta, como um stream de mídia ou uma playlist HLS.

404 Not Found

Esse código indica que o servidor não encontrou nada que corresponda à URL solicitada. Possíveis causas:

• endereço da URL incompleto ou com erro de digitação
• o link temporário para o canal expirou e não está mais disponível
• o canal foi desativado no servidor
• o servidor não consegue retransmitir o canal por causa de erros de recepção

403 Forbidden

Indica que o servidor entendeu a requisição do cliente, mas se recusa a atendê-la. Possíveis causas:

• o token temporário expirou ou não foi enviado
• o acesso ao canal é restrito por endereço IP (localização GEO) ou pelo cabeçalho User-Agent
• o acesso foi revogado pelo administrador do servidor

Connection timeout

Normalmente ocorre quando a requisição do cliente ao servidor demora tempo demais. Possíveis causas:

• problemas de rede
• servidores sobrecarregados ou limite de conexões configurado
• restrição do servidor quanto à duração permitida da conexão
• restrições de firewall na conexão
• número de porta ou endereço do servidor incorretos

Por que a qualidade do stream fica pior depois da retransmissão?

Ao trabalhar com recepção HLS, é possível encontrar problemas de qualidade depois de retransmitir um stream. Por exemplo, um stream pode ser reproduzido em qualidade HD no VLC, mas depois da retransmissão o vídeo aparece em baixa resolução. Isso normalmente acontece porque o stream HLS contém variantes com resoluções diferentes.

Para resolver, baixe a playlist HLS e abra em um editor de texto. A playlist vai ter um conteúdo parecido com este:

#EXTM3U
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=6221600,RESOLUTION=1920x1080
https://example.com/video/1080.m3u8
#EXT-X-STREAM-INF:PROGRAM-ID=1,BANDWIDTH=246440,RESOLUTION=320x184
https://example.com/video/240.m3u8

Examine o conteúdo da playlist e procure as linhas #EXT-X-STREAM-INF, que definem os streams de qualidades diferentes disponíveis. Neste exemplo, há dois streams: um com resolução de 1920x1080 e outro com resolução de 320x184.

Escolha a URL correspondente à qualidade desejada. Na playlist do exemplo, a URL do stream HD é https://example.com/video/1080.m3u8

Use essa URL nas configurações de entrada