Mayk IP TV

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

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

Повна специфікація формату плейлистів M3U для IPTV. Вивчіть теги Рівнів 1 і 2, парсинг каналів та інтерактивно перевіряйте списки.

Вступ до формату M3U в Mayk IP TV

Формат плейлистів M3U є загальноприйнятим стандартом для передавання списків IPTV-каналів. Mayk IP TV підтримує як класичні файли M3U, так і сучасні M3U8 списки з розширеними метаданими.

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

Дійсний файл M3U обов'язково починається директивою #EXTM3U, після якої йдуть упорядковані пари рядків метаданих #EXTINF та прямих посилань на потік.

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

Медіавміст автоматично розподіляється на прямий ефір, художні фільми або окремі серії на основі шаблонів сезонів на зразок 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).