Guia de EPG IPTV: Configuração, XMLTV e resolução de problemas

O que é EPG e porque importa?

EPG significa Guia Eletrónico de Programação — é o horário no ecrã que mostra o que está a passar agora e o que vem a seguir em cada canal. Pense nele como o equivalente digital de uma revista de programação de TV. Um bom EPG exibe o título do programa, hora de início e fim, descrição, género e por vezes informação de episódios. Sem EPG, a sua experiência IPTV resume-se a mudar canais às cegas e esperar encontrar algo que valha a pena assistir. Com EPG ativado, pode navegar pelo horário completo, ver detalhes de programas de relance e navegar pela sua lista de canais de forma muito mais eficiente. Para utilizadores com listas grandes contendo milhares de canais, o EPG torna-se ainda mais valioso porque ajuda a identificar rapidamente o que vale a pena assistir numa vasta seleção.

Como funciona o EPG com IPTV

Ao contrário da TV por cabo tradicional onde o EPG está incorporado no sinal de transmissão, o EPG IPTV é entregue como um ficheiro de dados separado que o seu player descarrega e faz a correspondência com os seus canais. O seu fornecedor IPTV ou uma fonte de EPG de terceiros aloja um ficheiro XML contendo horários de programação para centenas ou milhares de canais. O seu player IPTV descarrega este ficheiro, analisa-o e tenta fazer a correspondência de cada entrada de EPG com o canal correspondente na sua lista M3U. A correspondência é feita usando identificadores — o seu ficheiro M3U contém um atributo tvg-id para cada canal, e o ficheiro EPG contém o mesmo identificador para as suas listagens de programas. Quando os IDs correspondem, o guia de programação aparece para esse canal. Se os IDs não corresponderem, o canal não terá dados de EPG mesmo que os horários existam no ficheiro. Este processo de correspondência é onde a maioria dos problemas de EPG tem origem.

Formato XMLTV explicado

XMLTV é o formato padrão usado para distribuir dados de EPG para IPTV. É um formato de ficheiro baseado em XML que contém duas secções principais: definições de canais e listagens de programas. A secção de canais define cada canal com um ID, nome de exibição e URL de ícone opcional. A secção de programas contém entradas individuais com hora de início, hora de fim, referência de canal, título, descrição e metadados opcionais como categorias, números de episódio e classificações. Os ficheiros XMLTV podem ser bastante grandes — um EPG cobrindo milhares de canais com uma semana de programação pode facilmente exceder 500 MB quando descomprimido. Por esta razão, a maioria dos fornecedores de EPG distribui os seus ficheiros em formato comprimido gzip (.xml.gz), que tipicamente reduz o tamanho do ficheiro em 90% ou mais. O seu player IPTV precisa de descarregar, descomprimir e analisar todo este ficheiro para exibir informação de programação.

Onde encontrar URLs de EPG para o seu fornecedor

O primeiro lugar a procurar o seu URL de EPG é o seu fornecedor IPTV. A maioria dos fornecedores inclui um URL de EPG juntamente com o URL da sua lista M3U, frequentemente no email de boas-vindas ou no painel da sua conta. Alguns fornecedores incorporam o URL de EPG diretamente no cabeçalho do ficheiro M3U usando o atributo url-tvg, o que permite que players compatíveis o detetem automaticamente. Se o seu fornecedor não oferece um URL de EPG dedicado, várias fontes de EPG mantidas pela comunidade agregam dados de programação para canais populares em todo o mundo. Estas incluem projetos alojados no GitHub que compilam dados XMLTV de horários de transmissão públicos. Tenha em mente que fontes de EPG da comunidade podem não cobrir todos os canais na sua lista, especialmente canais regionais ou de nicho. Para os melhores resultados, tente sempre primeiro o URL de EPG do seu fornecedor, pois será especificamente desenhado para corresponder aos identificadores de canais deles.

Configurar EPG no seu player IPTV

Na maioria dos players IPTV, a configuração de EPG requer que insira manualmente o URL XMLTV nas definições do aplicativo e espere que os dados sejam descarregados e processados. Isto pode demorar vários minutos dependendo do tamanho do ficheiro e da sua ligação à internet. Alguns players requerem que acione manualmente uma atualização de EPG, enquanto outros atualizam num horário definido. O Easy IP TV adota uma abordagem fundamentalmente diferente — deteta os seus dados de EPG automaticamente. Quando adiciona o URL da sua lista M3U, o servidor do Easy IP TV lê o cabeçalho url-tvg do seu ficheiro M3U e processa os dados de EPG nos nossos servidores, não na sua TV. Se o seu M3U incluir um URL de EPG válido, o guia de programação aparecerá automaticamente sem qualquer configuração. Isto elimina completamente o passo de configuração manual e evita os problemas de desempenho que ocorrem quando uma Smart TV tenta descarregar e analisar um ficheiro XMLTV grande localmente.

Problemas comuns de EPG e como resolvê-los

O problema de EPG mais comum são canais sem dados de programação. Isto normalmente significa que o tvg-id na sua lista M3U não corresponde ao ID do canal no ficheiro XMLTV. Verifique o seu ficheiro M3U para o atributo tvg-id e compare-o com os IDs de canal na fonte de EPG — devem corresponder exatamente, incluindo maiúsculas/minúsculas. Horários de programas errados são outro problema frequente, tipicamente causado por incompatibilidades de fuso horário. Os ficheiros XMLTV especificam horários em UTC com um offset (ex.: +0200), mas se o seu player não processar a conversão corretamente, os horários aparecerão deslocados por várias horas. O EPG não carregar de todo frequentemente indica um problema de conectividade — o URL XMLTV pode estar em baixo, com limite de taxa ou bloqueado. Tente abrir o URL diretamente num navegador web para verificar se está acessível. Dados de EPG incompletos, onde apenas alguns canais têm listagens, normalmente significa que a fonte de EPG não cobre todos os canais na sua lista. Isto é especialmente comum com listas muito grandes ou canais regionais de nicho.

Atualização e agendamento de EPG

Os dados de EPG não são estáticos — os horários de programação mudam e novas listagens são adicionadas diariamente. A maioria das fontes XMLTV atualiza os seus dados a cada 12 a 24 horas, pelo que o seu player IPTV precisa de redescarregar o ficheiro regularmente para se manter atualizado. A frequência com que o seu player atualiza o EPG depende do aplicativo. Alguns players permitem definir um intervalo de atualização, enquanto outros atualizam apenas ao iniciar ou quando aciona manualmente. Intervalos de atualização frequentes (ex.: a cada 6 horas) garantem que o seu guia se mantém preciso mas consomem mais largura de banda e poder de processamento no seu dispositivo. Para Smart TVs com recursos limitados, downloads frequentes de XMLTV grandes podem causar lentidão ou até crashes. A abordagem ideal é transferir a atualização de EPG para um servidor que lida com o download, análise e correspondência centralmente. Desta forma, a sua TV recebe apenas os dados de EPG processados e relevantes sem a sobrecarga de lidar com ficheiros XML massivos.

Porque o mapeamento de EPG do lado do servidor é superior

Os players IPTV tradicionais processam o EPG inteiramente no dispositivo cliente — a sua TV descarrega o ficheiro XMLTV, analisa o XML e tenta fazer a correspondência dos canais. Esta abordagem tem limitações sérias. As Smart TVs têm RAM e poder de processamento limitados, pelo que analisar um ficheiro XML de 500 MB pode demorar minutos e pode causar o crash do aplicativo. A correspondência do lado do cliente depende de correspondências exatas de ID, pelo que mesmo pequenas discrepâncias entre o tvg-id do seu M3U e o ID do canal do EPG resultam em dados de programação em falta. O Easy IP TV move todo este processamento para os nossos servidores. Descarregamos e analisamos o ficheiro XMLTV em hardware de servidor potente, realizamos correspondência inteligente de canais que vai além da simples comparação de IDs, e entregamos apenas os dados de EPG relevantes à sua TV num formato otimizado. O resultado é que o seu guia de programação carrega instantaneamente, faz a correspondência de mais canais com precisão e nunca causa problemas de desempenho no seu dispositivo — mesmo que a sua lista tenha mais de 200.000 canais com um ficheiro EPG correspondentemente massivo.

FAQ