#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
Технічна документація
Специфікація формату плейлистів 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) · Необов'язково | String | trt1.tr | Унікальний код, що зв'язує канал із відповідним записом у файлі XMLTV EPG. |
tvg-name | Стандартний (Рівень 1) · Необов'язково | String | TRT 1 HD | Офіційна назва каналу, зафіксована в електронному розкладі телепередач. |
tvg-logo | Стандартний (Рівень 1) · Необов'язково | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Пряма веб-адреса зображення логотипа каналу (бажано PNG або SVG через HTTPS). |
group-title | Стандартний (Рівень 1) · Необов'язково | String | National | Назва категорії чи групи, до якої канал зараховується в меню додатка. |
#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 / Integer | series-id="show-42" | Унікальний ідентифікатор серіалу, що об'єднує потоки серій разом. |
series-name | Розширений (Рівень 2) · Необов'язково | String | series-name="Example Series" | Канонічна назва телесеріалу для об'єднання сезонів та окремих серій. |
season | Розширений (Рівень 2) · Необов'язково | Integer | season="1" | Номер сезону для серій телевізійних серіалів (ціле число). |
episode | Розширений (Рівень 2) · Необов'язково | Integer | episode="4" | Номер серії в межах вказаного сезону (ціле число). |
is_adult | Розширений (Рівень 2) · Необов'язково | Integer ("0" | "1") | is_adult="1" | Індикатор батьківського замка: '1' позначає вміст для дорослих. |
age_rating | Розширений (Рівень 2) · Необов'язково | String | age_rating="18+" | Позначка мінімального віку (наприклад, '18+') для батьківського контролю. |
Правила класифікації вмісту
| Тип | # | Приклад значення |
|---|---|---|
| Прямий ефір | #3 | http(s)://... | media-type="live" |
| Фільм (VOD) | #2 | /movie/... | media-type="movie" |
| Серія серіалу | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Зразки шаблонів
#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).