Um EPG correto depende de três elos da cadeia: uma fonte XMLTV acessível, o mesmo identificador de canal na playlist e no arquivo XMLTV, e um tratamento correto dos horários. Verifique esses níveis nessa ordem, em vez de atualizar o aplicativo repetidas vezes.
Pontos-chave
- A reprodução e os dados de programação são recursos independentes.
- O tvg-id da playlist deve corresponder ao channel id do XMLTV.
- Um deslocamento uniforme de horário geralmente indica um problema de fuso horário ou de offset.
- Nunca publique uma URL XMLTV privada em um fórum ou em uma captura de tela.
Os três elos da cadeia do guia de programação
A playlist descreve as entradas de mídia. O XMLTV descreve os canais e seus programas. O player precisa associar os dois lados por meio de um identificador estável e, depois, converter os horários dos programas para o fuso horário do dispositivo.
Os nomes exibidos não bastam. Dois nomes diferentes podem corresponder pelo mesmo ID técnico, enquanto nomes idênticos podem não corresponder quando seus IDs são diferentes.
Um diagnóstico em cinco minutos
- Confirme que a entrada de mídia é reproduzida; caso contrário, o EPG não é o primeiro problema.
- Verifique se a playlist declara um guia por meio de url-tvg, ou se o proprietário da fonte fornece separadamente uma URL XMLTV autorizada.
- Verifique apenas o domínio da URL em um navegador, sem expor o endereço privado completo nem os parâmetros.
- Atualize a playlist e o guia e deixe a sincronização terminar.
- Compare um tvg-id da playlist com o channel id correspondente no XMLTV.
Interprete o sintoma
| Sintoma | Causa provável | Verificação útil |
|---|---|---|
| Nenhum programa em lugar nenhum | XMLTV ausente, inacessível ou vazio | Endereço declarado, status de rede, tamanho do arquivo e datas |
| Apenas algumas entradas vazias | tvg-id ausente ou divergente | Correspondência exata do identificador |
| Todos os programas estão deslocados | Problema de fuso horário ou offset da fonte | Horário no XMLTV, fuso do dispositivo e horário de verão |
| Programa na entrada errada | Mapeamento duplicado ou incorreto | Valores únicos de channel id e tvg-id |
| O guia esvazia depois de alguns dias | XMLTV não é mais atualizado ou cache expirado | Data do último programa e frequência de atualização |
O que um player pode e não pode corrigir
Um player pode baixar, armazenar em cache, indexar e exibir os dados que recebe. Ele pode deduzir algumas correspondências pelo nome, mas essa dedução pode associar por engano dois canais diferentes.
Ele não pode inventar programas ausentes nem corrigir de forma permanente IDs inconsistentes na fonte. A solução confiável é o administrador legítimo da fonte corrigir a playlist ou o arquivo XMLTV.
Informações que tornam um relato de bug útil
- Tipo de fonte: M3U, Xtream Codes ou Stalker/Ministra.
- Número aproximado de entradas afetadas, sem expor conteúdo privado.
- Deslocamento de horário observado e fuso horário do dispositivo.
- Versão do aplicativo e modelo do dispositivo.
- Horário da última atualização bem-sucedida.
- Nunca inclua URL, senha, token, MAC ou captura de tela com credenciais.
Perguntas frequentes
Por que a reprodução funciona sem guia de TV?
Os endereços de reprodução e os dados de programação são recursos separados. Um pode continuar disponível enquanto o outro está ausente ou expirado.
Mudar o fuso horário da TV sempre corrige um deslocamento?
Só quando o fuso do dispositivo está errado. Se os horários do XMLTV estiverem codificados incorretamente, são os dados da fonte que precisam ser corrigidos.
Referências técnicas
O DringTV é apenas um player de mídia. Ele não fornece, vende nem recomenda nenhum canal, playlist, portal ou conteúdo. Use apenas fontes que você tem autorização para acessar e siga as regras do proprietário da fonte e a legislação do seu país.