XMLTV¶

mw.epg.xmltv

Адреса¶

Адреса относительны корню установки: если витрина открывается как https://tv.example.com/tv/, то обычный плейлист лежит по https://tv.example.com/playback/tv/playlist.m3u8, а IPTV — по https://tv.example.com/playback/tv/iptv.m3u8.

Токеном годится любой из двух:

• токен плейбека подписчика — тот, что виден оператору в карточке подписчика, поле Токен плейбека;
• токен устройства, полученный при входе в витрину.

Разница только в отзыве: отозвав устройство, оператор гасит и его ссылку, а токен плейбека живёт с самим подписчиком.

Что внутри XMLTV¶

Файл содержит объявления каналов и их передачи. Окно по умолчанию — сутки назад и шесть вперёд: прошедшие сутки нужны догону, который плеер строит по этому же файлу, а шесть суток — предел выдачи сетки.

Окно можно задать явно параметрами from и to — моментами в формате RFC 3339, например ?from=2026-08-20T00:00:00Z&to=2026-08-22T00:00:00Z.

Время передач всегда приводится к UTC и записывается в форме XMLTV YYYYMMDDHHMMSS +0000. Передача, у которой границы не разбираются, пропускается: плеер с одной битой датой рисует пустой сеткой весь файл, а не одну строку.

Расписание берётся из программы передач. Если сетка пуста, XMLTV приедет с объявлениями каналов, но без передач — и чинится это на стороне источника, а не выгрузки.

Ограничения¶

• Потолок экранов действует и здесь. Просмотр из стороннего плеера занимает экран так же, как просмотр в витрине; уперевшись в потолок, плеер получит отказ (Сколько экранов одновременно).
• Догон в обычном плейлисте плеер строит сам, по границам передачи из XMLTV. В IPTV-плейлисте окно объявлено в записи, если у стрима есть архив. Что записано, определяет архив стрима: за его пределами воспроизведения не будет.
• Файл не обновляется сам. Появился новый канал в подписке — абонент перекачивает плейлист. IPTV-файл перекачивают ещё и когда кончился допуск в ссылках.