EPG é o guia eletrônico que relaciona canais, horários e informações editoriais. Ele não faz parte dos quadros de vídeo e não confirma, por si só, que uma transmissão está correta ou autorizada.
EPG é uma camada de metadados
O player combina duas entradas: a fonte de vídeo e os dados de programação. O EPG pode informar identificador do canal, título, descrição, idioma, categoria, classificação, horário de início e fim, além de outros campos opcionais. Se a associação falha, o vídeo pode abrir normalmente e a grade continuar vazia.
Esses dados costumam ser preparados por emissoras, operadores ou fornecedores especializados. Mudanças de última hora, eventos que se estendem e diferenças entre grades regionais podem fazer a programação real divergir do que já foi publicado.
O papel do XMLTV
XMLTV é um formato de intercâmbio baseado em XML. Em termos gerais, o documento declara canais e blocos de programação. Cada programa aponta para um canal, traz início e fim e pode incluir título, subtítulo, sinopse, idioma e classificação. O formato transporta os dados; ele não cria nem valida editorialmente a grade.
O player baixa o arquivo ou consulta a URL configurada, interpreta os registros e os mantém em cache. Arquivos grandes, XML inválido, resposta incompleta ou servidor indisponível podem impedir a importação. Quando o aplicativo oferece registros, procure erros de download e análise antes de refazer toda a configuração.
Fluxo simplificado
Fonte autorizada de metadados → documento XMLTV → cache do player → associação pelo identificador → grade apresentada no fuso local.
Associação entre canal e programa
O nome visível do canal nem sempre é a chave usada no mapeamento. Em muitas integrações, a lista de reprodução fornece um identificador que deve corresponder ao identificador do canal no EPG. Espaços, sufixos de qualidade ou nomes regionais podem impedir uma correspondência automática.
Corrija o identificador na origem administrada ou use o recurso de associação manual do player, quando existir. Evite mapear apenas pela semelhança do nome: canais de regiões diferentes podem compartilhar uma marca e ter grades distintas.
Fuso horário e horário de verão
Um registro de programação precisa representar um instante, não apenas “oito da noite”. Fontes bem formadas incluem o deslocamento em relação ao UTC ou adotam uma convenção documentada. O player então converte o horário para o fuso configurado no sistema.
Uma grade inteira deslocada pelo mesmo intervalo normalmente aponta para interpretação de fuso, ajuste manual aplicado duas vezes ou relógio do aparelho incorreto. Diferenças apenas em certos canais podem indicar mapeamento regional errado. Regras sazonais também devem vir da base de fuso do sistema, e não de um deslocamento fixo improvisado.
- Ative data, hora e fuso automáticos no aparelho.
- Remova compensações manuais antigas no player.
- Confirme se os timestamps da fonte trazem fuso documentado.
- Atualize a base de dados e limpe o cache do EPG antes de comparar.
Atualização e cache
O EPG é uma fotografia editorial sujeita a mudanças. A fonte deve publicar revisões, e o aplicativo precisa buscá-las. Atualizar pouco deixa dados antigos; atualizar de forma excessiva gera tráfego e carga sem corrigir uma origem que ainda não foi revisada.
Verifique a última atualização bem-sucedida e o período coberto pela grade. Se a fonte está correta no servidor, mas o aparelho mostra dados antigos, force uma atualização documentada ou limpe somente o cache do guia. Apagar todos os dados do aplicativo pode remover favoritos e outras configurações, portanto deve ser uma medida deliberada.
Diagnóstico rápido
Grade vazia em todos os canais
Valide URL, autenticação, resposta do servidor, XML e importação do player.
Grade vazia em um canal
Confira a correspondência entre os identificadores da lista e do XMLTV.
Todos os horários deslocados
Revise fuso do aparelho, timestamp da fonte e compensação manual.
Programas antigos
Confira data da última importação, janela publicada e cache local.
Título não combina com o vídeo
Verifique região, canal associado e mudança editorial de última hora.
Fonte autorizada e dados protegidos
Use XMLTV fornecido por emissoras, operadores ou agregadores que autorizem esse uso. Metadados, descrições, imagens e marcas podem ter direitos próprios; uma URL pública não equivale a licença para copiar ou redistribuir. A autorização do EPG também não concede direitos sobre o vídeo.
Prefira HTTPS e não compartilhe URLs que contenham tokens ou credenciais. Feeds desconhecidos podem expor hábitos de acesso, redirecionar o player ou entregar arquivos malformados.
Perguntas frequentes
EPG e lista de canais são o mesmo arquivo?
Não necessariamente. A lista aponta para os streams; o EPG descreve horários e programas. O player associa as duas camadas.
Por que só alguns canais mostram programação?
Eles podem não existir na fonte de dados ou usar identificadores que não correspondem aos configurados na lista.
Ajustar o fuso manualmente é a melhor solução?
É um recurso de diagnóstico, não a primeira correção. Prefira timestamps completos e fuso correto no sistema para evitar ajustes duplicados.