Mayk IP TV

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ăNivelTipValoare exempluDescriere
#EXTM3UStandard (Nivelul 1) · ObligatoriuDirective (Header)#EXTM3ULinie obligatorie de antet care identifică fișierul ca fiind un playlist M3U extins.
#EXTINFStandard (Nivelul 1) · ObligatoriuDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDDirectivă de informații despre pistă ce specifică durata și atributele de metadate.
tvg-idStandard (Nivelul 1) · OpționalStringtrt1.trCod de identificare unic ce leagă canalul de înregistrarea din fișierul XMLTV EPG.
tvg-nameStandard (Nivelul 1) · OpționalStringTRT 1 HDDenumirea oficială a canalului înregistrată în ghidul electronic de programe.
tvg-logoStandard (Nivelul 1) · OpționalURL (http/https)https://stream.example.com:8080/images/trt1.pngAdresă directă către imaginea cu sigla canalului (de preferat PNG sau SVG prin HTTPS).
group-titleStandard (Nivelul 1) · OpționalStringNationalDenumirea categoriei în care canalul este plasat în meniul aplicației.
#EXTGRP:Standard (Nivelul 1) · OpționalDirective#EXTGRP:NationalDirectivă alternativă de grup plasată imediat după linia EXTINF.

Nivelul 2: Etichete extinse Mayk IP TV

Câmp / EtichetăNivelTipValoare exempluDescriere
media-typeExtins (Nivelul 2) · OpționalEnum ("live" | "movie" | "series")media-type="series"Suprascriere explicită a tipului media: 'live', 'movie' sau 'series'.
series-idExtins (Nivelul 2) · OpționalString / Integerseries-id="show-42"Identificator unic de serial ce grupează mai multe episoade.
series-nameExtins (Nivelul 2) · OpționalStringseries-name="Example Series"Titlu canonic al serialului TV pentru agregarea sezoanelor și episoadelor.
seasonExtins (Nivelul 2) · OpționalIntegerseason="1"Numărul sezonului pentru episoadele de seriale TV (număr întreg).
episodeExtins (Nivelul 2) · OpționalIntegerepisode="4"Numărul episodului în cadrul sezonului respectiv (număr întreg).
is_adultExtins (Nivelul 2) · OpționalInteger ("0" | "1")is_adult="1"Indicator de blocare parentală: '1' marchează conținutul pentru adulți.
age_ratingExtins (Nivelul 2) · OpționalStringage_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#3http(s)://... | media-type="live"
Film (VOD)#2/movie/... | media-type="movie"
Episod de serial#1/series/... + S01E01 / S01.E01 | media-type="series"

Șabloane demonstrative

Televiziune în direct (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) & Episod de serial (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

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).