IdiomaPortuguês

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

FasePerguntaExemplo de falha
ObterFoi possível obter o recurso do guia?Não foi possível contactar o servidor
InterpretarA resposta pôde ser lida no formato esperado?Chegou uma página de erro HTML em vez de XMLTV
AssociarOs canais do guia correspondem aos canais da lista?Os identificadores referem outra emissão regional
ApresentarExistem 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.

Referências

Perguntas frequentes

Uma atualização do guia bem-sucedida significa que todos os canais têm programas?
Não. Uma atualização pode obter e interpretar dados válidos que não abrangem os identificadores dos seus canais ou o período consultado. Verifique a correspondência e a cobertura dos horários separadamente do sucesso da transferência.
Dois canais podem ter nomes semelhantes e programações diferentes?
Sim. Emissões regionais, versões com atraso e edições diferentes podem partilhar nomes apresentados semelhantes, mas transmitir programas diferentes. Compare os identificadores dos canais pretendidos e os detalhes das emissões.
O XMLTV inclui o próprio vídeo?
Não. O XMLTV descreve canais e programas. O vídeo chega através de uma transmissão separada, e uma entrada no guia não fornece direitos de acesso, reprodução de programas anteriores nem uma gravação.