#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
Tekninen viite
M3U-soittolistan muotoilumääritys
Kattava M3U-soittolistan muotoilumääritys IPTV:lle. Opi Tason 1 ja Tason 2 tunnisteet, kanavajäsennys ja validoi soittolistat.
Johdanto M3U-muotoon Mayk IP TV:ssä
M3U-soittolista on vakiintunut standardi IPTV-kanavaluetteloille. Mayk IP TV tukee sekä perinteisiä M3U-tiedostoja että uudempia M3U8-tiedostoja kattavilla metatiedoilla.
Soittolistan rakenne ja syntaksi
Kelvollinen M3U-tiedosto alkaa aina #EXTM3U-otsikkorivillä, jota seuraavat peräkkäiset parit #EXTINF-tietorivejä ja suoratoisto-osoitteita.
VOD- ja sarjasisällön luokittelu
Sisältö lajitellaan automaattisesti suoriksi lähetyksiksi, elokuviksi tai sarjajaksoiksi kausitunnisteiden kuten S01 E02 perusteella.
Jäsennyksen parhaat käytännöt
Varmista puhdas UTF-8-merkistökoodaus, toimivat HTTP/HTTPS-linkit ja yksilölliset tvg-id-tunnisteet EPG-ohjelmaoppaan toimivuuden takaamiseksi.
Taso 1: Vakiomuotoiset #EXTINF-tunnisteet
| Kenttä / Tunniste | Taso | Tyyppi | Esimerkkiarvo | Kuvaus |
|---|---|---|---|---|
#EXTM3U | Vakio (Taso 1) · Pakollinen | Directive (Header) | #EXTM3U | Pakollinen aloitusotsikkorivi, joka määrittelee tiedoston laajennetuksi M3U-soittolistaksi. |
#EXTINF | Vakio (Taso 1) · Pakollinen | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Kappaletietodirektiivi, joka määrittää suoratoiston keston ja metatiedot. |
tvg-id | Vakio (Taso 1) · Valinnainen | String | trt1.tr | Yksilöllinen tunniste, joka yhdistää kanavan XMLTV EPG -tietoihin. |
tvg-name | Vakio (Taso 1) · Valinnainen | String | TRT 1 HD | Virallinen kanavan nimi sähköisessä ohjelmaoppaassa. |
tvg-logo | Vakio (Taso 1) · Valinnainen | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Suora verkko-osoite kanavan logokuvaan (mieluiten PNG tai SVG HTTPS-yhteydellä). |
group-title | Vakio (Taso 1) · Valinnainen | String | National | Luokan tai ryhmän nimi, johon kanava sijoitetaan sovelluksen valikossa. |
#EXTGRP: | Vakio (Taso 1) · Valinnainen | Directive | #EXTGRP:National | Vaihtoehtoinen ryhmittelydirektiivi heti EXTINF-rivin alapuolella. |
Taso 2: Mayk IP TV Laajennetut tunnisteet
| Kenttä / Tunniste | Taso | Tyyppi | Esimerkkiarvo | Kuvaus |
|---|---|---|---|---|
media-type | Laajennettu (Taso 2) · Valinnainen | Enum ("live" | "movie" | "series") | media-type="series" | Eksplisiittinen mediatyypin ohitus: 'live', 'movie' tai 'series'. |
series-id | Laajennettu (Taso 2) · Valinnainen | String / Integer | series-id="show-42" | Yksilöllinen sarjatunniste, joka ryhmettelee jaksojen suoratoistot yhteen. |
series-name | Laajennettu (Taso 2) · Valinnainen | String | series-name="Example Series" | Sarjan kanoninen nimi kausien ja jaksojen kokoamiseksi yhteen. |
season | Laajennettu (Taso 2) · Valinnainen | Integer | season="1" | Kausinumero televisiosarjojen jaksoille (kokonaisluku). |
episode | Laajennettu (Taso 2) · Valinnainen | Integer | episode="4" | Jakson numero kyseisellä kaudella (kokonaisluku). |
is_adult | Laajennettu (Taso 2) · Valinnainen | Integer ("0" | "1") | is_adult="1" | Lapsilukon merkintä: '1' osoittaa aikuisille suunnattua sisältöä. |
age_rating | Laajennettu (Taso 2) · Valinnainen | String | age_rating="18+" | Vähimmäisikäraja (esim. '18+') lapsilukkosuodattimia varten. |
Sisällön luokittelusäännöt
| Tyyppi | # | Esimerkkiarvo |
|---|---|---|
| Suora TV | #3 | http(s)://... | media-type="live" |
| Elokuva (VOD) | #2 | /movie/... | media-type="movie" |
| Sarjan jakso | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Esimerkkimallit
#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
Interaktiivinen muodon tarkistus
Liitä M3U-katkelma tai Xtream JSON -vastaus alle tarkistaaksesi yhteensopivuuden Mayk IP TV:n kanssa.
M3U-yhteensopivuuden tarkistuslista
- Varmista, että tiedoston ensimmäinen rivi on tarkalleen #EXTM3U.
- Käytä kestona arvoa -1 kaikille jatkuville suorille televisiokanaville.
- Määritä oikeat tvg-id-arvot, jotka vastaavat XMLTV-ohjelmatietojasi.
- Ryhmittele kanavat selkeästi käyttämällä group-title-määritteitä.
- Tallenna tiedosto UTF-8-muodossa ilman tavujärjestysmerkkiä (BOM).