Artigos
Formato M3U: como interpretar uma lista de canais
Aprenda a interpretar uma lista M3U, os campos EXTINF e tvg-id e a verificar os endereços dos canais com segurança antes de importar a sua lista.
Publicado por InoxTV · Publicado
Última atualização
O formato de listas M3U é texto que descreve entradas multimédia e indica onde encontrá-las. Ler um pequeno exemplo ajuda a distinguir um problema no catálogo de uma falha de reprodução antes de alterar definições da aplicação. O exemplo abaixo é deliberadamente fictício: o domínio reservado para exemplos não fornece televisão, e copiá-lo para um leitor não disponibiliza canais funcionais.
Comece por um exemplo pequeno e legível
#EXTM3U
#EXTINF:-1 tvg-id="demo.news" group-title="Examples",Example News
https://media.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="demo.documentary" group-title="Examples",Example Documentary
https://media.example.com/documentary/index.m3u8
A primeira linha anuncia um ficheiro M3U alargado. Cada entrada contém depois uma linha descritiva seguida de uma localização. Neste exemplo, as localizações apontam para listas HLS, mas uma entrada M3U não precisa de terminar nessa extensão. O endereço pode representar outro formato multimédia suportado ou um ponto de acesso de servidor que devolve conteúdos sem um nome de ficheiro evidente.
Ao inspecionar um ficheiro seu ou cuja utilização está autorizada, abra uma cópia num editor de texto simples. Evite processadores de texto que alterem as aspas ou gravem formatação complexa. Preserve o original para que uma experiência com uma etiqueta não se transforme na única cópia da sua lista funcional.
O que revelam os campos descritivos
A linha EXTINF contém informações associadas à entrada seguinte. Em muitos catálogos IPTV, a duração menos um representa uma entrada sem duração fixa conhecida. O texto depois da vírgula é o nome apresentado. Os atributos anteriores são convenções utilizadas por determinados leitores e fornecedores; o suporte não é idêntico em todas as aplicações.
| Campo do exemplo | Finalidade | O que não demonstra |
|---|---|---|
tvg-id="demo.news" | Identificador de canal que pode ser associado aos dados do guia | Que existe uma entrada correspondente no guia |
group-title="Examples" | Categoria sugerida para organizar as entradas | Que todos os leitores interpretam os grupos da mesma forma |
Example News | Nome legível do canal | Que a transmissão está disponível ou licenciada |
| O URL seguinte | Localização solicitada para reproduzir o conteúdo | Que a conta tem autorização para aceder |
Quando existe um endereço de logótipo, este é outro recurso que a interface pode solicitar. Uma imagem em falta não significa necessariamente que o vídeo esteja avariado. Da mesma forma, um logótipo apresentado corretamente não constitui um teste de reprodução. Distinguir nomes, imagens, identificadores e localizações do vídeo torna as observações mais precisas.
Uma lista de canais pode apontar para outra lista
É normal que o catálogo exterior contenha endereços cujas respostas sejam também listas. A lista exterior responde à questão de qual canal foi selecionado. Um manifesto HLS pode descrever depois as versões multimédia ou a sequência de pequenos segmentos utilizados para entregar esse canal. São camadas diferentes, mesmo quando utilizam uma sintaxe de texto relacionada.
Por isso, a presença do sufixo M3U8 não basta para decidir se um endereço deve ser usado num importador de catálogos ou num leitor multimédia. A comparação entre M3U e HLS explica as etiquetas que permitem distinguir os casos. Siga as instruções da origem autorizada em vez de mudar extensões até um importador aceitar o ficheiro.
Verifique os identificadores quando falta o guia
No exemplo fictício, o identificador demo.news pode corresponder a um canal declarado num guia XMLTV. Os registos dos programas referem esse identificador do canal do guia. Se a origem utilizar demo.news.hd, nomes apresentados semelhantes não garantem uma correspondência. O comportamento exato depende da aplicação e das convenções utilizadas pela origem dos dados.
Antes de editar identificadores, compare o catálogo e o guia que foram concebidos para funcionar em conjunto. Uma emissão regional pode utilizar um identificador diferente do de uma emissão nacional com nome parecido. Substituir nomes indiscriminadamente num ficheiro grande pode criar associações incorretas. Trabalhe primeiro num exemplo bem compreendido e leia como funciona a correspondência XMLTV antes de alterar a lista inteira.
Inspecione a estrutura sem expor a conta
Um endereço pode incluir credenciais no caminho e também depois de um ponto de interrogação. Ocultar apenas um parâmetro chamado password não é suficiente. Um token, número de conta ou endereço assinado pode aparecer noutra posição. Ao preparar um exemplo para assistência, substitua a localização completa por um endereço reservado para exemplos e descreva a resposta ou o erro separadamente.
Não envie uma lista privada para um formatador ou validador online apenas porque oferece uma pré-visualização conveniente. Um catálogo descarregado pode revelar todos os endereços de transmissão associados à conta. Guarde cópias em armazenamento sob o seu controlo e considere quem pode aceder a uma pasta sincronizada. O guia de privacidade das listas inclui uma lista prática dos dados a ocultar.
Reconheça o que uma edição pode resolver
Uma cópia em texto simples pode revelar um endereço incompleto, uma quebra de linha acidental ou uma página de início de sessão HTML guardada com extensão M3U. São descobertas úteis. Contudo, um ficheiro com sintaxe aparentemente correta pode apontar para conteúdos indisponíveis. Alterar um grupo, identificador ou sufixo de ficheiro não renova uma conta, ultrapassa restrições do servidor nem concede autorização para ver conteúdos.
Se o catálogo carregar mas uma entrada falhar, registe se outras entradas funcionam e se a falha acompanha a mesma transmissão autorizada noutra configuração compatível. Se não conseguir importar o catálogo, preserve a resposta original e consulte o guia de problemas ao carregar listas. Depois de compreender a estrutura, o guia de configuração M3U do InoxTV apresenta os passos concretos de importação.
