Artigos
Guia XMLTV: como os programas encontram o canal certo
Compreenda identificadores XMLTV, referências dos programas e cobertura dos horários, e porque um guia descarregado pode continuar sem programação.
Publicado por InoxTV · Publicado
Última atualização
Um guia eletrónico XMLTV é uma programação, não uma transmissão de vídeo. Contém descrições de canais e registos de programas que fazem referência a esses canais. Para apresentar informações úteis, o leitor precisa de associar os identificadores do guia aos canais da lista e selecionar os programas que abrangem o período relevante. Cada etapa pode falhar independentemente, mesmo quando o ficheiro do guia é descarregado com sucesso.
Acompanhe um identificador através dos dados
O exemplo fictício abaixo declara um canal com o identificador demo.news. O respetivo programa aponta para esse identificador através do atributo channel. O nome apresentado é texto legível; o identificador é a referência que liga os registos. As datas, o título e o canal são ilustrativos e não representam uma programação real.
<tv>
<channel id="demo.news">
<display-name>Example News</display-name>
</channel>
<programme channel="demo.news"
start="20261102180000 +0000"
stop="20261102183000 +0000">
<title lang="en">Evening bulletin</title>
</programme>
</tv>
Uma entrada correspondente no catálogo pode incluir tvg-id="demo.news". A utilização desse atributo por um determinado leitor depende da sua implementação e das convenções da origem. Um nome de canal parecido não constitui uma regra universal de correspondência. O ponto de partida mais seguro é uma lista e um guia publicados deliberadamente para funcionarem em conjunto, seguidos da configuração documentada pela aplicação.
Se não conhece os atributos do catálogo, comece pelo exemplo M3U comentado. Este distingue o nome apresentado do identificador do guia e do endereço da transmissão, permitindo comparar o campo correto sem alterar a localização utilizada para reproduzir.
Distinga quatro fases de uma atualização
| Fase | Pergunta | Exemplo de falha |
|---|---|---|
| Obter | Foi possível obter o recurso do guia? | Não foi possível contactar o servidor |
| Interpretar | A resposta pôde ser lida no formato esperado? | Chegou uma página de erro HTML em vez de XMLTV |
| Associar | Os canais do guia correspondem aos canais da lista? | Os identificadores referem outra emissão regional |
| Apresentar | Existem programas para a hora selecionada? | A origem contém apenas a programação de ontem |
As mensagens de estado da aplicação não mostram necessariamente todas estas fases. Uma mensagem de sucesso pode indicar que a atualização terminou sem erro operacional, deixando ainda assim um canal sem entradas. Interprete a mensagem em conjunto com um canal e um período específicos. Não altere repetidamente o endereço do guia antes de perceber razoavelmente qual é a fase que exige atenção.
Identifique uma incompatibilidade com um exemplo controlado
Escolha um canal cujo programa esperado consiga identificar. Registe a emissão ou edição regional exata, em vez de apenas o nome da marca. Compare o identificador da lista com a declaração do canal no guia e com as referências dos programas, quando tiver autorização para inspecioná-los. Por exemplo, demo.news e demo.news.west podem descrever emissões diferentes, mesmo que ambas mostrem Example News.
Alterar todos os identificadores para um nome simplificado pode agravar a situação. Duas emissões distintas podem ficar reduzidas ao mesmo nome, associando uma programação ao vídeo errado. Guarde uma cópia de qualquer ficheiro editado, teste primeiro uma entrada e preserve as distinções previstas pela origem. Uma substituição global de texto não é uma alternativa fiável à compreensão da correspondência entre os dados.
Verifique o período abrangido e também o canal
Um guia pode incluir a declaração de um canal sem conter registos de programas para amanhã. Também pode abranger apenas parte dos canais de uma lista extensa. Nenhuma destas situações significa que o XML esteja malformado. Verifique o início e o fim reais da cobertura dos programas antes de interpretar uma zona vazia da grelha como uma falha na transferência.
Os horários dos programas exigem uma interpretação cuidadosa. No exemplo, +0000 é um desvio UTC explícito. Outra origem pode descrever o mesmo instante utilizando uma hora local e um desvio diferentes. Se o programa correto aparecer à hora errada, investigue os carimbos temporais e a conversão em vez de alterar o identificador do canal. O artigo sobre fusos horários do guia explica esse cálculo.
Um guia maior nem sempre é mais útil
Um guia com muitos países e semanas de programação pode exigir mais memória, processamento e tempo de transferência do que uma origem mais específica. O tamanho nada diz sobre a correspondência dos seus canais. Prefira uma origem autorizada com os canais certos, cobertura adequada e um processo de atualização previsível. Considere as capacidades do televisor ou dispositivo de transmissão que efetivamente processa os dados.
A compressão pode reduzir o tamanho da transferência, mas o dispositivo continua a precisar de processar os dados descomprimidos. Uma pequena transferência comprimida pode gerar bastante mais trabalho durante a interpretação. Reduzir o histórico guardado pode ajudar em algumas aplicações, mas não garante que uma origem demasiado grande passe a ser processável. Siga as definições documentadas e observe a atualização resultante, sem presumir um limite específico de memória.
Transforme as observações num relato útil
Registe se a atualização indica sucesso, quais os canais afetados, a data selecionada, o fuso horário do dispositivo e um programa esperado. Indique se falta toda a programação ou se apenas uma emissão está incorreta. Essa distinção ajuda a separar um problema de ligação de uma falha de cobertura ou correspondência. Não partilhe endereços privados do guia que contenham tokens da conta.
No InoxTV, as instruções de configuração do guia explicam onde configurar as origens, e a página de resolução de programação em falta aborda as mensagens de estado da aplicação. Utilize este artigo para compreender a relação entre os dados e consulte essas páginas para os passos exatos da interface. Depois de resolver o problema, confirme o resultado em mais de um programa e data.
