Analisador HLS

Atualizado 16 de outubro de 2026

O analisador HLS do iiPTV lê um manifesto HLS e transforma as informações declaradas no texto em um relatório fácil de consultar. Ele diferencia listas principais de listas de mídia e mostra variantes, codecs, faixas, duração dos segmentos e sinalização de criptografia. A análise se limita ao manifesto: ela não baixa nem decodifica o vídeo.

Use o analisador HLS quando a fonte responde, mas você não sabe quais opções de qualidade e áudio estão disponíveis ou como a lista está organizada. Carregue um arquivo, cole o texto ou informe o link de um manifesto que você tenha autorização para acessar. As requisições remotas saem do navegador diretamente para a fonte, então as permissões de acesso entre origens continuam valendo.

Nesta página: analisar um manifesto, conferir variantes, entender as durações, comparar um exemplo, conhecer os limites e tirar dúvidas.

Carregue um manifesto no analisador HLS

Use o texto do manifesto ou seu endereço, que geralmente termina em .m3u8, em vez da página de um site com um player incorporado. A análise precisa conseguir ler o texto da lista. Uma página de login ou um erro em HTML não vira uma lista HLS só porque o endereço tem a extensão esperada, mesmo que a resposta HTTP indique sucesso.

Execute a análise e confira primeiro o tipo de manifesto identificado. Uma lista principal descreve as versões disponíveis e as faixas relacionadas. Uma lista de mídia descreve os segmentos de uma dessas versões. O relatório não consegue montar uma escada completa de qualidades adaptativas se a lista de mídia não trouxer essa informação.

Se não for possível ler a resposta, use o verificador de streams para separar problemas de acesso dos problemas de interpretação do manifesto. Mantenha o link em sigilo se ele contiver um identificador da sua assinatura. Repetir a análise não renova credenciais vencidas, transforma uma origem HTTP em HTTPS nem libera o acesso entre origens.

Confira variantes, CODECS e faixas

Em uma lista principal, avalie a resolução junto com a largura de banda. O analisador mostra o que o responsável pela fonte declarou; ele não mede o vídeo comprimido nem verifica quantos pixels há em um segmento. Uma largura de banda declarada maior não comprova que a fonte tem qualidade melhor, principalmente quando as variantes usam codecs diferentes.

Uma mesma declaração de codec pode descrever vídeo e áudio. O relatório mantém esses dados visíveis porque o navegador pode reconhecer o contêiner e ainda assim não ter um decodificador para uma das faixas. O suporte também depende do navegador, do sistema operacional e dos recursos de mídia do dispositivo.

Grupos de áudio e legendas

Faixas alternativas podem ter nomes, idiomas e identificadores de grupo. Confira esses grupos para saber se o manifesto realmente declara a opção antes de concluir que o player a escondeu. Uma legenda listada comprova apenas que existe uma declaração nos metadados; o arquivo separado ainda pode falhar quando o player tentar acessá-lo.

A taxa de quadros e os endereços relativos das variantes também ajudam a entender a fonte. O analisador mostra a estrutura declarada; um teste de reprodução ainda precisa buscar a variante escolhida e seus recursos. Consulte a página de compatibilidade para distinguir os recursos disponíveis no player da especificação completa de HLS.

Entenda a duração-alvo e a janela de segmentos

Uma lista de mídia pode declarar uma duração-alvo e a duração de cada segmento. O analisador usa esses valores para descrever a janela presente na lista. Em uma transmissão ao vivo, essa janela muda conforme a fonte adiciona segmentos e remove os antigos. Por isso, anote quando a análise foi feita.

Uma lista com um marcador de encerramento é diferente de uma janela ao vivo em andamento. As tags de criptografia descrevem como a proteção é sinalizada; elas não comprovam que você tem acesso à chave. A análise não busca chaves, remove proteções nem oferece acesso a conteúdo protegido por DRM.

As definições do protocolo estão na RFC 8216. Esta ferramenta ajuda na inspeção prática e não oferece uma certificação completa de conformidade. Mesmo um arquivo de texto que parece válido pode apontar para recursos de mídia ausentes, inconsistentes ou incompatíveis.

Compare uma lista principal com uma lista de mídia

Imagine uma lista principal com uma variante de 640×360 a 800.000 bits por segundo e outra de 1280×720 com uma largura de banda declarada maior. O analisador torna essas duas opções visíveis. Para saber qual delas sua conexão consegue manter, ainda é necessário comparar a reprodução.

Agora imagine uma lista de mídia com dois segmentos, um de seis segundos e outro de quatro. A duração listada é de dez segundos, mesmo que a tag de duração-alvo indique seis. São conceitos diferentes: a duração-alvo não é a duração total do programa, e a janela ao vivo não representa necessariamente a transmissão inteira.

Conheça os limites da análise e das requisições diretas

As requisições do analisador HLS partem do seu navegador para a origem escolhida. Elas não usam um proxy do iiPTV para contornar permissões. Falhas de CORS e restrições a conteúdo misto podem impedir o relatório mesmo quando a fonte funciona em um aplicativo nativo. Essa diferença não comprova que o manifesto esteja incorreto.

A leitura da resposta tem um limite para evitar que um recurso inesperadamente grande ocupe a aba. O relatório é concluído sem baixar segmentos de vídeo ou chaves. Em outras partes do iiPTV, as importações de listas de canais aceitam até 5 MiB e 10.000 itens; esses limites do catálogo são independentes da linha do tempo de um manifesto.

Dúvidas sobre o analisador HLS

Posso analisar um manifesto DASH?

Este relatório é voltado a manifestos de texto HLS. Um documento DASH .mpd tem outra estrutura. O verificador de streams pode conferir a disponibilidade da resposta, mas mudar o nome do arquivo não converte DASH em HLS nem adiciona um decodificador ao player.

Um relatório sem problemas garante a reprodução?

Não. Abra uma mídia compatível no player iiPTV e toque em Reproduzir. Uma variante, um segmento ou um codec pode falhar depois que o manifesto inicial for carregado. A ajuda de reprodução explica essa sequência sem confundir importação bem-sucedida com decodificação bem-sucedida.

Posso compartilhar o manifesto original?

Confira o conteúdo e oculte dados sensíveis antes de compartilhar. Os endereços de variantes, chaves e segmentos podem conter tokens privados. Envie apenas o menor exemplo sem dados sensíveis necessário para explicar o problema e guarde a fonte original em particular se precisar comparar alterações depois.