Mayk IP TV

Technická dokumentácia

Špecifikácia formátu playlistu M3U

Kompletná špecifikácia formátu playlistu M3U pre IPTV. Naučte sa tagy Úrovne 1 a 2, parsovanie kanálov a validujte playlisty interaktívne.

Úvod do formátu M3U v aplikácii Mayk IP TV

Formát playlistu M3U slúži ako univerzálny štandard pre zoznamy staníc IPTV. Mayk IP TV spoľahlivo podporuje tradičné súbory M3U aj moderné zoznamy M3U8 s bohatými metadátami.

Štruktúra a syntax playlistu

Platný súbor M3U začína vždy deklaráciou #EXTM3U, za ktorou nasledujú usporiadané dvojice riadkov metadát #EXTINF a priamych adries URL streamov.

Klasifikácia filmov a seriálov

Multimediálny obsah sa automaticky zatrieďuje medzi živé vysielanie, filmy a epizódy seriálov na základe vzorov sérií, ako je napríklad S01 E02.

Osvedčené postupy pri spracovaní

Vždy dbajte na čisté kódovanie UTF-8, funkčné internetové adresy HTTP/HTTPS a jedinečné hodnoty tvg-id pre bezchybný televízny program (EPG).

Úroveň 1: Štandardné tagy #EXTINF

Pole / TagÚroveňTypPríklad hodnotyPopis
#EXTM3UŠtandardné (Úroveň 1) · PovinnéDirective (Header)#EXTM3UPovinný hlavičkový riadok označujúci súbor ako rozšírený playlist M3U.
#EXTINFŠtandardné (Úroveň 1) · PovinnéDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDirektíva informácií o stope určujúca dĺžku streamu a atribúty metadát.
tvg-idŠtandardné (Úroveň 1) · VoliteľnéStringtrt1.trJedinečný kód prepájajúci kanál s príslušným záznamom v súbore XMLTV EPG.
tvg-nameŠtandardné (Úroveň 1) · VoliteľnéStringTRT 1 HDOficiálny názov televíznej stanice evidovaný v elektronickom programovom sprievodcovi.
tvg-logoŠtandardné (Úroveň 1) · VoliteľnéURL (http/https)https://stream.example.com:8080/images/trt1.pngPriamy odkaz na obrázok s logom stanice (odporúča sa formát PNG alebo SVG cez HTTPS).
group-titleŠtandardné (Úroveň 1) · VoliteľnéStringNationalNázov kategórie, do ktorej je kanál zaradený v rozhraní prehrávača.
#EXTGRP:Štandardné (Úroveň 1) · VoliteľnéDirective#EXTGRP:NationalAlternatívna direktíva skupiny umiestnená hneď za riadkom EXTINF.

Úroveň 2: Rozšírené tagy Mayk IP TV

Pole / TagÚroveňTypPríklad hodnotyPopis
media-typeRozšírené (Úroveň 2) · VoliteľnéEnum ("live" | "movie" | "series")media-type="series"Explicitné prepísanie typu média: 'live', 'movie' alebo 'series'.
series-idRozšírené (Úroveň 2) · VoliteľnéString / Integerseries-id="show-42"Jedinečný identifikátor seriálu združujúci streamy epizód.
series-nameRozšírené (Úroveň 2) · VoliteľnéStringseries-name="Example Series"Kanonický názov televízneho seriálu na zoskupenie sérií a častí.
seasonRozšírené (Úroveň 2) · VoliteľnéIntegerseason="1"Číslo série pre epizódy televízneho seriálu (celé číslo).
episodeRozšírené (Úroveň 2) · VoliteľnéIntegerepisode="4"Číslo epizódy v rámci danej série (celé číslo).
is_adultRozšírené (Úroveň 2) · VoliteľnéInteger ("0" | "1")is_adult="1"Príznak rodičovského zámku: '1' označuje obsah pre dospelých.
age_ratingRozšírené (Úroveň 2) · VoliteľnéStringage_rating="18+"Minimálna veková hranica (napr. '18+') pre filtre rodičovskej kontroly.

Pravidlá klasifikácie obsahu

Typ#Príklad hodnoty
Živé vysielanie#3http(s)://... | media-type="live"
Film (VOD)#2/movie/... | media-type="movie"
Epizóda seriálu#1/series/... + S01E01 / S01.E01 | media-type="series"

Vzorové šablóny

Živé vysielanie (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
Film (VOD) & Epizóda seriálu (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

Interaktívna kontrola formátu

Vložte nižšie úryvok M3U alebo odpoveď JSON Xtream na overenie kompatibility s Mayk IP TV.

Kontrolný zoznam kompatibility M3U

  • Uistite sa, že úplne prvý riadok súboru obsahuje presne #EXTM3U.
  • Pre všetky nepretržité živé stanice nastavte dĺžku trvania na -1.
  • Priraďte správne hodnoty tvg-id zodpovedajúce vášmu zdroju XMLTV.
  • Stanice logicky zoskupujte pomocou atribútu group-title.
  • Súbory ukladajte v čistom kódovaní UTF-8 bez značky poradia bajtov (BOM).