IdiomaPortuguês

Artigos

M3U ou M3U8: uma lista de canais nem sempre é um manifesto de vídeo

Compare catálogos de canais M3U com listas HLS M3U8 de variantes e segmentos, através de exemplos que explicam o que cada ficheiro descreve.

Publicado por InoxTV · Publicado

Última atualização

Comparar M3U com M3U8 torna-se mais simples quando separamos o nome do ficheiro da sua função. Um catálogo IPTV pode listar muitos canais. Um manifesto HLS pode descrever como entregar uma apresentação. Ambos podem utilizar a sintaxe de listas alargadas, e um catálogo de canais pode apontar para um manifesto HLS. A aparência semelhante não os torna entradas intercambiáveis em todas as aplicações.

O que revela a extensão

M3U é um formato de listas com uma longa história nas aplicações multimédia. Por convenção, a extensão M3U8 indica texto UTF-8, capaz de representar nomes de canais e outras informações em diversos sistemas de escrita. O HLS utiliza um formato de lista definido, com etiquetas obrigatórias e regras próprias. Ver o número oito no nome do ficheiro não demonstra que essas regras sejam cumpridas.

Alguns servidores disponibilizam listas através de endereços sem qualquer destes sufixos. Outros utilizam parâmetros para escolher o formato da resposta. Um ficheiro descarregado chamado playlist.txt pode, portanto, conter dados úteis de uma lista, enquanto channels.m3u8 pode conter uma página de início de sessão ou uma resposta de erro. O conteúdo, o tipo de conteúdo e as instruções da origem esclarecem mais do que uma extensão presumida.

Primeira camada: um catálogo de canais

Um catálogo responde a uma questão de navegação: que opções deve o leitor apresentar? Cada entrada tem normalmente um nome e um endereço de reprodução, podendo incluir grupos e identificadores do guia. Estes campos organizam a interface. Não descrevem a compressão do vídeo nem a divisão de uma emissão em direto em pequenos elementos descarregáveis.

#EXTM3U
#EXTINF:-1 tvg-id="demo.news",Example News
https://media.example.com/news/master.m3u8

Esta entrada fictícia apresenta um canal chamado Example News. O endereço seguinte é o próximo recurso que o leitor solicitaria após a seleção. O vídeo não está incorporado no catálogo. Para conhecer melhor os metadados opcionais, consulte como interpretar uma lista de canais M3U. O domínio reservado do exemplo não fornece qualquer emissão funcional.

Segunda camada: várias versões HLS

Uma lista HLS com várias variantes, denominada master playlist no RFC 8216, pode anunciar versões alternativas da mesma apresentação. Estas podem diferir na taxa de bits, resolução ou outras características. Um leitor compatível pode escolher entre as opções anunciadas conforme a sua implementação, a capacidade estimada da ligação e as capacidades do dispositivo. A adaptação só é possível quando existem alternativas adequadas.

#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=1500000,RESOLUTION=640x360
low/index.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=4500000,RESOLUTION=1280x720
high/index.m3u8

Este exemplo simplificado aponta para duas listas subordinadas. Os valores de largura de banda descrevem as variantes anunciadas; não são um teste de velocidade da sua ligação à Internet. Os caminhos relativos são resolvidos a partir do endereço do manifesto. Copiar apenas um caminho relativo para outro contexto faz perder o endereço de base necessário para o localizar. Manifestos reais podem incluir informações adicionais sobre áudio, legendas e codecs.

Terceira camada: uma sequência de segmentos multimédia

Uma lista multimédia identifica os elementos que formam uma versão ao longo do tempo. As entradas podem incluir durações, informações de sequência e localizações dos segmentos. Numa apresentação em direto, a lista pode mudar à medida que surgem novos segmentos e os antigos saem da janela de visualização. Uma cópia descarregada corretamente pode, por isso, ficar desatualizada; abrir repetidamente uma cópia antiga não equivale a acompanhar um serviço em direto.

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:100
#EXTINF:6.0,
segment100.ts
#EXTINF:6.0,
segment101.ts

Os endereços dos segmentos acima são fictícios. As durações descrevem partes de uma apresentação, não canais separados. A etiqueta EXTINF também aparece noutros contextos M3U alargados, pelo que deve identificar as etiquetas HLS circundantes em vez de decidir a partir de uma única linha familiar. O RFC 8216 define o comportamento obrigatório das listas e etiquetas adicionais para encriptação, descontinuidades e outros aspetos da entrega.

Porque ajuda esta distinção a diagnosticar problemas

Uma lista de canais funcional demonstra que foram obtidas informações do catálogo. Um manifesto de variantes funcional demonstra que foram obtidas descrições das versões. Nenhum destes resultados prova que todos os recursos seguintes estejam disponíveis ou autorizados. A reprodução ainda pode falhar ao solicitar uma lista subordinada ou um segmento, ou quando o dispositivo tenta descodificar os conteúdos recebidos.

Isto também explica porque a ligação pode parecer ativa enquanto a primeira imagem demora a surgir. Podem ser necessários vários pedidos dependentes antes de chegar ao descodificador uma quantidade suficiente de dados reproduzíveis. A sequência de início da reprodução distingue essas fases. Associe o sintoma aos indícios da respetiva fase, em vez de concluir genericamente que o formato da lista está avariado.

Ao investigar um erro, considere toda a relação entre os recursos. Um pedido a um servidor pode ter sucesso enquanto um pedido posterior de conteúdos segue para outro servidor, com disponibilidade ou requisitos de autorização diferentes.

Utilize o ponto de entrada indicado pela origem

Se o fornecedor autorizado disponibiliza um endereço de catálogo de canais, importe-o através do procedimento documentado para listas. Não o substitua por um segmento aleatório ou um manifesto subordinado encontrado durante a inspeção. Esses endereços podem ser temporários, estar associados a uma sessão ou ser inadequados como entradas permanentes. Um endereço que reproduziu uma vez não constitui necessariamente uma configuração estável.

Ao pedir ajuda, explique se o problema surge na importação do catálogo, na seleção de uma versão ou na reprodução dos conteúdos. Não publique manifestos privados nem endereços assinados. Para conhecer os campos de configuração suportados pelo InoxTV, consulte o guia de configuração M3U; para compreender a terminologia da qualidade de imagem, leia sobre taxa de bits, resolução e frequência de imagens.

Referências

Perguntas frequentes

Mudar a extensão de .m3u para .m3u8 converte uma transmissão para HLS?
Não. Alterar o nome do ficheiro não cria etiquetas HLS, segmentos multimédia nem uma codificação compatível. O conteúdo do ficheiro e as respostas do servidor determinam a forma como os conteúdos são entregues.
M3U8 representa sempre um único canal de televisão?
Não. A extensão está associada a listas em texto UTF-8 e é utilizada pelo HLS, mas não identifica por si só a finalidade do ficheiro. Inspecione o conteúdo e siga as instruções de configuração da origem.
Porque pode o manifesto abrir e a reprodução continuar a falhar?
O manifesto é apenas um dos pedidos. As listas, chaves ou segmentos que referencia podem estar indisponíveis, exigir autorização ou utilizar formatos não suportados. Receber o primeiro ficheiro de texto não testa toda a cadeia de reprodução.