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 фрагмент или Xtream JSON отговор по-долу, за да проверите съвместимостта с Mayk IP TV.

Контролен списък за съвместимост с M3U

  • Уверете се, че първият ред на файла съдържа точно #EXTM3U.
  • Задайте продължителност -1 за всички непрекъснати канали на живо.
  • Свържете валидни tvg-id стойности с вашия XMLTV източник на данни.
  • Групирайте каналите логично чрез атрибута group-title.
  • Записвайте файловете в чисто кодиране UTF-8 без маркер за порядък на байтовете (BOM).