XMLTV¶
mw.epg.xmltv
Endereços¶
| O quê | Endereço |
|---|---|
| Lista de canais | /playback/tv/playlist.m3u8?token=<token> |
| Lista de canais para reprodutores IPTV | /playback/tv/iptv.m3u8?token=<token> |
| Guia de programação | /playback/tv/xmltv.xml?token=<token> |
Os endereços são relativos à raiz da instalação: se a vitrine abre em https://tv.example.com/tv/, a lista habitual fica em https://tv.example.com/playback/tv/playlist.m3u8, e a IPTV em https://tv.example.com/playback/tv/iptv.m3u8.
Qualquer um dos dois tokens serve:
- o token de reprodução do assinante — aquele que o operador vê na ficha dele, campo Token de reprodução;
- um token de dispositivo obtido ao entrar na vitrine.
A diferença está só na revogação: ao revogar um dispositivo, o link dele também se apaga, enquanto o token de reprodução vive com o próprio assinante.
O que há dentro do XMLTV¶
O arquivo traz as declarações de canais e seus programas. A janela padrão é de um dia para trás e seis para frente: o dia passado é o que o catch-up precisa, e seis dias é o próprio limite do guia.
A janela pode ser definida com os parâmetros from e to — momentos no formato RFC 3339, por exemplo ?from=2026-08-20T00:00:00Z&to=2026-08-22T00:00:00Z.
Os horários dos programas são sempre convertidos para UTC e escritos na forma XMLTV YYYYMMDDHHMMSS +0000. Um programa cujos limites não podem ser lidos é ignorado: uma única data quebrada faz o reprodutor desenhar o arquivo inteiro como uma grade vazia, e não apenas aquela linha.
A programação vem do guia de programação. Se ele estiver vazio, o XMLTV chega com as declarações de canais e sem programas — e isso se resolve na fonte, não na exportação.
Limites¶
- O limite de telas vale aqui também. Uma reprodução num reprodutor externo ocupa uma tela igual a uma na vitrine; ao bater no limite, o reprodutor recebe uma recusa (Quantas telas ao mesmo tempo).
- O catch-up na lista habitual é montado pelo próprio reprodutor, com os limites do programa que vêm no XMLTV. Na lista IPTV a janela é declarada na entrada se o stream tiver arquivo. O que está gravado é decidido pelo arquivo do stream: além dele não há o que reproduzir.
- O arquivo não se atualiza sozinho. Surgiu um canal novo na assinatura, o assinante baixa a lista de novo. A lista IPTV também se baixa de novo quando a permissão dos links acaba.