🗓️EPG в плеере

В основном автоматическое, и работает в 2 режимах:

  1. Полный: источник XMLTV поддерживается плеером, в таком случае серверная часть пытается максимально точно подобрать значки и программу к каналам. Для каналов, по которым этого сделать не удалось, работает автопоиск EPG, согласно приоритетам, на сервере.
  2. Стандартный: источник XMLTV не поддерживается плеером, в таком случае сразу работает автопоиск EPG, согласно приоритетам, на сервере

Также, я получаю ссылки на источники тв программы, которые указаны в плейлистах, что позволяет мне определять популярные источники и добавлять для них режим полной поддержки.

Терминология

В статье используются термины, значение которых Вы должны знать, вот их список с пояснениями:

  • IPTV поставщик ip телевидения.
  • M3U/M3U8 это плейлист, ссылку на который Вы вбиваете в плеер
  • EPG-FOSS формат программы, совместимый с этим плеером, легко создается из XMLTV этим (opens new window) инструментом
  • Заголовок плейлиста/#EXTM3U первая строка в плейлисте, в ней как правило могут содержаться глобальные установки листа, стандарта толком нет
    • url-tvg параметр плейлиста, относящийся к секции #EXTM3U, в нем прописываются источники телепрограммы для каналов, иногда пишут несколько источников через ,
      • EPG/телегид телепрограмма для канала, обычно ищется по источникам из url-tvg, имеет несколько форматов XMLTV и JTV
  • #EXTINF строка в которой содержатся данные канала(для каждого своя строка), в основном имя, но сюда пишут также группу, кол-во часов архива, идентификатор для url-tvg и прочие полезные данные, стандарта толком нет
    • tvg-id параметр канала, относящийся к секции #EXTINF используется для привязки EPG к каналу (в основном XMLTV), часто бывает цифровым, что ведет к проблемам если указано несколько url-tvg в листе с каналами от разных IPTV.
    • tvg-name параметр канала, относящийся к секции #EXTINF используется для привязки EPG к каналу (не точно, но в основном для JTV). Обычно сюда пишут "сырое имя" канала, например каналы СТС, СТС +2, СТС +4, будут иметь одинаковый tvg-name, но разные tvg-shift, 0,+2,+4 соответственно.
    • tvg-source параметр канала, относящийся к секции #EXTINF используется этим плеером, для приоритизации EPG, непосредственно для канала, подробнее тут

Автопоиск

Работает как и в оригинальном плеере, но с изменениями, которые на мой взгляд лучше влияют на качество поиска.

Имеется поддержка приоритетных источников, в первую очередь поиск выполняется по url-tvg которые, удалось обнаружить в заголовке плейлиста, или явно указаны в tvg-source, если определены этих два параметра, то второй логично дополняет первый.

Плеер пытается найти EPG для канала по следующим атрибутам (указаны в порядке очереди поиска, регистр символов не учитывается):

  1. tvg-id если в заголовке плейлиста указан и поддерживается источник url-tvg, то соответствие сначала будет искаться по этим источникам.
    🪧 если url-tvg пуст, то поиск по tvg-id игнорируется

Обратите внимание, что tvg-id предназначен для привязки канала к одному url-tvg. Если в плейлисте несколько url-tvg, да еще и tvg-id цифровой, это может привести к проблемам.
Пример: У Вас объединенный плейлист двух IPTV с несколькими url-tvg, tvg-id у обоих цифровой (допустим начинается с 1), ни один плеер не сможет по tvg-id в такой ситуации корректно сопоставить EPG.

  1. Если предыдущий шаг не дал результата, или был пропущен, то далее поиск ведется по атрибуту tvg-name и далее по названию канала, все с учетом приоритетных источников, из url-tvg или tvg-source.

Ручной режим

Для желающих настроить лист "под себя" осталась возможность из оригинального плеера (opens new window) влиять на подбираемую программу.
В FOSS версии этот процесс переработан, теперь нет привязки к одному серверу, можно указать свой, можно "гвоздями прибивать" программу к телеканалам, можно грузить другие иконки.

Таким образом поддержку любого провайдера в плеере можно довести до 100%, даже без желания разработчика.
Подробнее тут

# Для провайдеров/Как добавить свой EPG?

Если у Вас есть качественный и стабильный источник EPG, я с радостью добавлю его в список автопоиска, и телегид на Вашем провайдере заработает в "полном" режиме.
Но, к сожалению Я ограничен в ресурсах и не смогу добавлять всех подряд, если вдруг я Вам отказал, то возможность добавить полную поддержку EPG в этом плеере все еще есть.
Подробнее тут