#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 и директни 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) · По избор | 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 фрагмент или Xtream JSON отговор по-долу, за да проверите съвместимостта с Mayk IP TV.
Контролен списък за съвместимост с M3U
- Уверете се, че първият ред на файла съдържа точно #EXTM3U.
- Задайте продължителност -1 за всички непрекъснати канали на живо.
- Свържете валидни tvg-id стойности с вашия XMLTV източник на данни.
- Групирайте каналите логично чрез атрибута group-title.
- Записвайте файловете в чисто кодиране UTF-8 без маркер за порядък на байтовете (BOM).