O que é EPG e por que o guia de TV fica vazio
O EPG (guia eletrônico de programação) é a grade que um player mostra ao lado de cada canal: o que está passando agora, o que vem depois e a programação dos próximos dias. No IPTV, ele não vem junto com o vídeo. É um arquivo separado, geralmente no formato XMLTV, que o fornecedor publica num endereço próprio; o player baixa e casa as entradas dele com os seus canais. Quando o guia fica vazio, uma dessas etapas falhou: não há endereço de guia, o download falhou, o arquivo não pode ser lido, ou as entradas não batem com os seus canais. Os canais, esses, continuam rodando.
De onde vem o guia
Três peças precisam se encaixar:
- Um endereço de guia. Com um acesso Xtream Codes, o endereço do guia do fornecedor vem junto com o acesso. Com um link M3U, o arquivo pode indicar um na primeira linha; muitos não indicam, e aí o player não tem guia para baixar até você adicionar um.
- O arquivo do guia. Um arquivo XMLTV lista os canais por um identificador e depois cada programa com hora de início, hora de fim, título e muitas vezes uma descrição. Para um pacote grande, ele tem dezenas de megabytes, muitas vezes compactados.
- Um casamento entre os dois. Cada canal da sua lista tem um identificador de guia (o
tvg-idde uma linha M3U). O player procura esse identificador no guia. Se os identificadores não batem, um player pode tentar pelo nome do canal, o que só funciona se os nomes forem parecidos.
Então um canal pode ter uma transmissão funcionando e guia nenhum. As duas coisas vêm de lugares diferentes.
Os cinco motivos de um guia vazio
| O que você vê | Causa mais provável | De que lado |
|---|---|---|
| O guia todo vazio, para todos os canais | A lista não tem endereço de guia | O seu; o endereço vem do fornecedor |
| O guia todo vazio, e uma mensagem fala do download | O endereço do guia não responde, ou responde com erro | Fornecedor |
| Alguns canais têm guia, outros não | Os identificadores desses canais faltam no arquivo | Fornecedor |
| O guia estava lá ontem e acabou | O guia cobre poucos dias, ou não foi atualizado | Fornecedor, ou uma atualização do seu lado |
| O guia está lá, mas em horários errados | Um fuso deslocado, não um guia vazio | Veja EPG com horário errado |
Sem endereço de guia
A causa mais comum com um link M3U. Peça ao fornecedor o endereço XMLTV dele; quem manda link M3U costuma ter um. Ele vai nas opções da lista, não no link.
O download falhou
O endereço existe, mas responde com erro, demora demais ou devolve uma página da web em vez de um arquivo. Isso é do fornecedor. Um guia que não baixa não para a reprodução: os canais continuam, sem programação.
Alguns canais batem, outros não
A lista do fornecedor e o guia dele muitas vezes são mantidos separados, e um canal renomeado ou novo entra num e não no outro. Nada no player consegue inventar a programação que falta. Mande ao fornecedor os canais sem guia, pelo nome.
O guia acabou
Um guia cobre um número fixo de dias. Alguns fornecedores publicam um ou dois, outros uma semana. Sem atualização, a grade esvazia pelo fim. Atualizar o guia todo dia mantém ele cheio até onde o fornecedor publica.
Descobrir em qual caso você está
Vá do sintoma mais amplo ao mais estreito:
- Algum canal mostra programação? Se nenhum mostra, olhe primeiro o endereço do guia. Abra as opções da lista e confira se há um endereço, ou se a lista trouxe um.
- O download avisou erro? Um download falho é o endereço do fornecedor que não responde. No Adless é E-EPG-FETCH, que também cobre um arquivo que chegou mas não dá para ler.
- A maioria dos canais tem programação e alguns não? O guia funciona e esses canais faltam nele. Compare um canal que funciona com um que falta: se o que falta foi renomeado ou adicionado há pouco, esse é o motivo.
- A programação está lá, mas vazia a partir de certo ponto? Veja quando o guia foi atualizado pela última vez, atualize e veja se o arquivo do fornecedor vai mais longe.
Acentos, cedilha e dois países
Quando um canal não tem identificador de guia, ou o dele não está no guia, o player tenta pelo nome, e nomes em português complicam mais do que parece. O mesmo canal pode estar escrito de um jeito na lista e de outro no guia:
- Acentos e cedilha. Na lista “Esporte Ação HD”, no guia “Esporte Acao”; “Notícias”, “Noticias”.
- Prefixos e sufixos. Muitas listas colocam na frente um código de país ou categoria (“BR:”, “PT |”, “[BR]”) e atrás uma qualidade (“HD”, “FHD”, “4K”). O guia quase nunca tem nenhum deles.
- Várias qualidades do mesmo canal. Três linhas na lista correspondem a uma entrada só no guia; as três precisam do mesmo identificador.
- O mesmo canal no Brasil e em Portugal. Algumas emissoras têm uma versão brasileira e uma portuguesa, com grade e fuso diferentes. Se a lista liga a versão brasileira ao guia português, a programação é real, mas de outra versão e de outro fuso.
O casamento por nome absorve parte dessas diferenças, não todas; o caminho confiável é o identificador. Se um canal mostra “Sem guia para este canal” enquanto outra qualidade do mesmo canal tem programação, mande ao fornecedor o nome das duas linhas: colocar o identificador que falta leva um minuto para ele.
O guia mostra o programa errado num canal
A programação está lá, mas é de outro canal. É um casamento pelo identificador errado: a lista dá ao canal um identificador que, no guia do fornecedor, pertence a outro canal, muitas vezes uma versão regional ou atrasada (canais “+1” passam a mesma grade uma hora depois). A correção é feita na lista, e com um acesso Xtream ou um link M3U do fornecedor, cabe a ele.
Se a programação é a certa mas na hora errada, com todos os canais deslocados igual, é problema de fuso e não de casamento: EPG com horário errado explica como medir a diferença.
Até onde um guia vai para a frente e para trás
Até onde o fornecedor publica. Um ou dois dias para a frente é o normal, uma semana é generoso. Para trás, um guia costuma guardar o último dia, mais nos canais com arquivo, porque um programa que você quer ver desde o início precisa estar no guia para ser encontrado.
Um player só consegue mostrar o que está no arquivo. Se a grade acaba amanhã à noite, o arquivo acaba ali.
Tamanho, internet e bateria
Um guia XMLTV completo de um pacote grande é pesado: dezenas de megabytes compactados, algumas vezes isso descompactado, com centenas de milhares de programas. Baixar nos dados móveis a cada poucas horas pesa com o tempo, e ler o arquivo dá alguns segundos de trabalho a um celular ou TV box. Por isso os players atualizam o guia por agenda em vez de a cada abertura, e por isso uma agenda sensata espera o Wi-Fi e o carregador.
Posso usar outro guia?
Pode, se tiver o endereço de outro guia XMLTV que cubra os seus canais com os mesmos identificadores. O player casa o guia que você dá com os identificadores da lista; um guia feito para outro pacote vai bater com poucos canais, ou com nenhum. O guia do fornecedor é feito para os identificadores dele, por isso é o primeiro a consertar quando falta.
Para que serve o guia além da grade
O guia permite três coisas num player. Gravar um programa até o fim precisa da hora de fim; gravar todos os episódios de uma série precisa que o guia liste os próximos; ver um programa desde o início precisa saber quando ele começou. Sem guia, um player ainda grava por um tempo fixo e toca o canal ao vivo, mas nada disso. Como gravar e ver desde o início funcionam no Adless está na página de gravação.
O Adless lê o guia que o seu fornecedor publica para a sua própria lista. Ele não fornece canais, listas nem guia próprio.
Leia a seguir
- O guia de IPTV mostra horários errados: achar a diferença Quando o guia de TV mostra os programas uma hora ou mais fora do lugar, a causa é um fuso horário, no aparelho ou no guia. Meça a diferença, entenda o que ela quer dizer e corrija do lado certo.
- M3U ou Xtream Codes: qual acesso usar O seu fornecedor mandou um link M3U e um acesso Xtream Codes para a mesma conta. O que cada um traz, como diferem num player IPTV e qual colocar primeiro.
- Player IPTV ou fornecedor de IPTV: quem faz o quê Um player IPTV é o app; um fornecedor de IPTV é a assinatura com os canais. Do que cada um cuida, por que o player vem sem canais e a quem recorrer quando algo quebra.