Mayk IP TV

Техническая документация

Спецификация формата плейлистов M3U

Полная спецификация формата плейлистов M3U для IPTV. Изучите теги Уровней 1 и 2, парсинг каналов и проверяйте плейлисты интерактивно.

Введение в формат M3U в Mayk IP TV

Формат плейлистов M3U служит общепринятой основой для списков каналов IPTV. Mayk IP TV полноценно поддерживает как классические файлы M3U, так и современные плейлисты M3U8 с метаданными.

Структура и синтаксис плейлиста

Корректный файл M3U всегда начинается с директивы #EXTM3U, за которой следуют последовательные пары строк метаданных #EXTINF и прямых URL-адресов потоков.

Классификация фильмов и сериалов

Медиаконтент автоматически классифицируется как прямой эфир, фильм или эпизод сериала на основе шаблонов сезонов, таких как S01 E02.

Рекомендации по надежному парсингу

Всегда сохраняйте файлы в кодировке UTF-8, используйте прямые ссылки HTTP/HTTPS и уникальные значения tvg-id для точного телегида (EPG).

Уровень 1: Стандартные теги #EXTINF

Поле / ТегУровеньТипПример значенияОписание
#EXTM3UСтандартный (Уровень 1) · ОбязательноDirective (Header)#EXTM3UОбязательная строка заголовка, определяющая файл как расширенный плейлист M3U.
#EXTINFСтандартный (Уровень 1) · ОбязательноDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDДиректива информации о дорожке, определяющая длительность и атрибуты метаданных.
tvg-idСтандартный (Уровень 1) · НеобязательноStringtrt1.trУникальный идентификатор, связывающий канал с записью в файле телепрограммы XMLTV EPG.
tvg-nameСтандартный (Уровень 1) · НеобязательноStringTRT 1 HDОфициальное название канала, зарегистрированное в электронном телегиде.
tvg-logoСтандартный (Уровень 1) · НеобязательноURL (http/https)https://stream.example.com:8080/images/trt1.pngПрямая веб-ссылка на изображение логотипа канала (желательно PNG или SVG по HTTPS).
group-titleСтандартный (Уровень 1) · НеобязательноStringNationalНазвание категории, в которую канал помещается в интерфейсе плеера.
#EXTGRP:Стандартный (Уровень 1) · НеобязательноDirective#EXTGRP:NationalАльтернативная директива группы, расположенная сразу за строкой EXTINF.

Уровень 2: Расширенные теги Mayk IP TV

Поле / ТегУровеньТипПример значенияОписание
media-typeРасширенный (Уровень 2) · НеобязательноEnum ("live" | "movie" | "series")media-type="series"Явное переопределение типа медиа: 'live', 'movie' или 'series'.
series-idРасширенный (Уровень 2) · НеобязательноString / Integerseries-id="show-42"Уникальный идентификатор сериала, объединяющий потоки эпизодов.
series-nameРасширенный (Уровень 2) · НеобязательноStringseries-name="Example Series"Каноническое название телесериала для объединения сезонов и серий.
seasonРасширенный (Уровень 2) · НеобязательноIntegerseason="1"Номер сезона для серий телевизионного проекта (целое число).
episodeРасширенный (Уровень 2) · НеобязательноIntegerepisode="4"Номер серии внутри указанного сезона (целое число).
is_adultРасширенный (Уровень 2) · НеобязательноInteger ("0" | "1")is_adult="1"Индикатор родительского контроля: '1' отмечает контент для взрослых.
age_ratingРасширенный (Уровень 2) · НеобязательноStringage_rating="18+"Метка минимального возраста (например, '18+') для родительских фильтров.

Правила классификации контента

Тип#Пример значения
Прямой эфир#3http(s)://... | media-type="live"
Фильм (VOD)#2/movie/... | media-type="movie"
Серия сериала#1/series/... + S01E01 / S01.E01 | media-type="series"

Примеры шаблонов

Прямой эфир (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
Фильм (VOD) & Серия сериала (M3U / #EXTINF)
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4

Интерактивная проверка формата

Вставьте фрагмент M3U или JSON-ответ Xtream ниже для проверки совместимости с Mayk IP TV.

Контрольный список совместимости M3U

  • Убедитесь, что самая первая строка файла в точности равна #EXTM3U.
  • Установите длительность в -1 для всех непрерывных каналов прямого эфира.
  • Сопоставьте корректные значения tvg-id с вашим источником данных XMLTV.
  • Логично группируйте каналы с помощью атрибута group-title.
  • Сохраняйте файлы в чистой кодировке UTF-8 без метки порядка байтов (BOM).