Mayk IP TV

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ä / TunnisteTasoTyyppiEsimerkkiarvoKuvaus
#EXTM3UVakio (Taso 1) · PakollinenDirective (Header)#EXTM3UPakollinen aloitusotsikkorivi, joka määrittelee tiedoston laajennetuksi M3U-soittolistaksi.
#EXTINFVakio (Taso 1) · PakollinenDirective (Metadata)#EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HDKappaletietodirektiivi, joka määrittää suoratoiston keston ja metatiedot.
tvg-idVakio (Taso 1) · ValinnainenStringtrt1.trYksilöllinen tunniste, joka yhdistää kanavan XMLTV EPG -tietoihin.
tvg-nameVakio (Taso 1) · ValinnainenStringTRT 1 HDVirallinen kanavan nimi sähköisessä ohjelmaoppaassa.
tvg-logoVakio (Taso 1) · ValinnainenURL (http/https)https://stream.example.com:8080/images/trt1.pngSuora verkko-osoite kanavan logokuvaan (mieluiten PNG tai SVG HTTPS-yhteydellä).
group-titleVakio (Taso 1) · ValinnainenStringNationalLuokan tai ryhmän nimi, johon kanava sijoitetaan sovelluksen valikossa.
#EXTGRP:Vakio (Taso 1) · ValinnainenDirective#EXTGRP:NationalVaihtoehtoinen ryhmittelydirektiivi heti EXTINF-rivin alapuolella.

Taso 2: Mayk IP TV Laajennetut tunnisteet

Kenttä / TunnisteTasoTyyppiEsimerkkiarvoKuvaus
media-typeLaajennettu (Taso 2) · ValinnainenEnum ("live" | "movie" | "series")media-type="series"Eksplisiittinen mediatyypin ohitus: 'live', 'movie' tai 'series'.
series-idLaajennettu (Taso 2) · ValinnainenString / Integerseries-id="show-42"Yksilöllinen sarjatunniste, joka ryhmettelee jaksojen suoratoistot yhteen.
series-nameLaajennettu (Taso 2) · ValinnainenStringseries-name="Example Series"Sarjan kanoninen nimi kausien ja jaksojen kokoamiseksi yhteen.
seasonLaajennettu (Taso 2) · ValinnainenIntegerseason="1"Kausinumero televisiosarjojen jaksoille (kokonaisluku).
episodeLaajennettu (Taso 2) · ValinnainenIntegerepisode="4"Jakson numero kyseisellä kaudella (kokonaisluku).
is_adultLaajennettu (Taso 2) · ValinnainenInteger ("0" | "1")is_adult="1"Lapsilukon merkintä: '1' osoittaa aikuisille suunnattua sisältöä.
age_ratingLaajennettu (Taso 2) · ValinnainenStringage_rating="18+"Vähimmäisikäraja (esim. '18+') lapsilukkosuodattimia varten.

Sisällön luokittelusäännöt

Tyyppi#Esimerkkiarvo
Suora TV#3http(s)://... | media-type="live"
Elokuva (VOD)#2/movie/... | media-type="movie"
Sarjan jakso#1/series/... + S01E01 / S01.E01 | media-type="series"

Esimerkkimallit

Suora TV (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
Elokuva (VOD) & Sarjan jakso (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

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