#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
Referință tehnică
Specificația formatului de playlist M3U
Specificație completă a formatului de playlist M3U pentru IPTV. Învățați etichetele de Nivel 1 și 2, parsarea canalelor și validați playlisturi.
Introducere în formatul M3U pentru Mayk IP TV
Formatul de playlist M3U reprezintă baza universală pentru listele de canale IPTV. Mayk IP TV acceptă atât fișiere clasice M3U, cât și fișiere moderne M3U8 cu metadate extinse.
Structura și sintaxa playlistului
Un fișier M3U valid debutează întotdeauna cu directiva #EXTM3U, urmată de perechi succesive de linii cu metadate #EXTINF și legături directe către fluxuri.
Clasificarea conținutului VOD și a serialelor
Conținutul este clasificat automat în transmisiuni live, filme sau episoade de seriale pe baza tiparelor de sezon precum S01 E02.
Bune practici pentru procesare
Asigurați-vă că folosiți codificarea UTF-8, legături HTTP/HTTPS valide și identificatori unici tvg-id pentru un ghid electronic de programe (EPG) corect.
Nivelul 1: Etichete standard #EXTINF
| Câmp / Etichetă | Nivel | Tip | Valoare exemplu | Descriere |
|---|---|---|---|---|
#EXTM3U | Standard (Nivelul 1) · Obligatoriu | Directive (Header) | #EXTM3U | Linie obligatorie de antet care identifică fișierul ca fiind un playlist M3U extins. |
#EXTINF | Standard (Nivelul 1) · Obligatoriu | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Directivă de informații despre pistă ce specifică durata și atributele de metadate. |
tvg-id | Standard (Nivelul 1) · Opțional | String | trt1.tr | Cod de identificare unic ce leagă canalul de înregistrarea din fișierul XMLTV EPG. |
tvg-name | Standard (Nivelul 1) · Opțional | String | TRT 1 HD | Denumirea oficială a canalului înregistrată în ghidul electronic de programe. |
tvg-logo | Standard (Nivelul 1) · Opțional | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Adresă directă către imaginea cu sigla canalului (de preferat PNG sau SVG prin HTTPS). |
group-title | Standard (Nivelul 1) · Opțional | String | National | Denumirea categoriei în care canalul este plasat în meniul aplicației. |
#EXTGRP: | Standard (Nivelul 1) · Opțional | Directive | #EXTGRP:National | Directivă alternativă de grup plasată imediat după linia EXTINF. |
Nivelul 2: Etichete extinse Mayk IP TV
| Câmp / Etichetă | Nivel | Tip | Valoare exemplu | Descriere |
|---|---|---|---|---|
media-type | Extins (Nivelul 2) · Opțional | Enum ("live" | "movie" | "series") | media-type="series" | Suprascriere explicită a tipului media: 'live', 'movie' sau 'series'. |
series-id | Extins (Nivelul 2) · Opțional | String / Integer | series-id="show-42" | Identificator unic de serial ce grupează mai multe episoade. |
series-name | Extins (Nivelul 2) · Opțional | String | series-name="Example Series" | Titlu canonic al serialului TV pentru agregarea sezoanelor și episoadelor. |
season | Extins (Nivelul 2) · Opțional | Integer | season="1" | Numărul sezonului pentru episoadele de seriale TV (număr întreg). |
episode | Extins (Nivelul 2) · Opțional | Integer | episode="4" | Numărul episodului în cadrul sezonului respectiv (număr întreg). |
is_adult | Extins (Nivelul 2) · Opțional | Integer ("0" | "1") | is_adult="1" | Indicator de blocare parentală: '1' marchează conținutul pentru adulți. |
age_rating | Extins (Nivelul 2) · Opțional | String | age_rating="18+" | Insignă de vârstă minimă (de ex. '18+') pentru filtrele de control parental. |
Reguli de clasificare a conținutului
| Tip | # | Valoare exemplu |
|---|---|---|
| Televiziune în direct | #3 | http(s)://... | media-type="live" |
| Film (VOD) | #2 | /movie/... | media-type="movie" |
| Episod de serial | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Șabloane demonstrative
#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
Verificator interactiv de format
Inserați fragmentul M3U sau răspunsul JSON Xtream mai jos pentru a verifica compatibilitatea cu Mayk IP TV.
Listă de verificare a compatibilității M3U
- Verificați dacă prima linie din fișier conține exact textul #EXTM3U.
- Setați durata la -1 pentru toate canalele de televiziune live continue.
- Asociați valori valide tvg-id corespunzătoare sursei dumneavoastră XMLTV.
- Organizați canalele pe categorii folosind atributul group-title.
- Salvați fișierul în codificare UTF-8 fără marcaj pentru ordinea octeților (BOM).