Artikler
M3U-formatet: sådan læser du en kanalliste
Læs et kommenteret eksempel på en M3U-liste, forstå EXTINF og tvg-id, og undersøg kanaladresser sikkert, før du importerer din egen liste.
Udgivet af InoxTV · Udgivet
Senest opdateret
M3U-formatet er tekst, der beskriver medieposter, og hvor de findes. Et kort eksempel kan hjælpe dig med at skelne mellem et katalogproblem og et afspilningsproblem, før du ændrer appens indstillinger. Eksemplet nedenfor er bevidst fiktivt: det reserverede eksempeldomæne er ikke en tv-kilde, og du får ingen fungerende kanaler ved at kopiere det ind i en afspiller.
Begynd med et lille og læsbart eksempel
#EXTM3U
#EXTINF:-1 tvg-id="demo.news" group-title="Examples",Example News
https://media.example.com/news/index.m3u8
#EXTINF:-1 tvg-id="demo.documentary" group-title="Examples",Example Documentary
https://media.example.com/documentary/index.m3u8
Den første linje angiver en udvidet M3U-fil. Derefter har hver post en linje med beskrivende oplysninger efterfulgt af en placering. I dette eksempel peger placeringerne på HLS-lister, men en M3U-post behøver ikke at slutte med den filendelse. Adressen kan repræsentere et andet understøttet medieformat eller et serverendepunkt, som returnerer medier uden et tydeligt filnavn.
Åbn en kopi i en almindelig teksteditor, når du undersøger en fil, du ejer eller har tilladelse til at bruge. Undgå tekstbehandlingsprogrammer, der ændrer anførselstegn eller gemmer formateret tekst. Bevar originalfilen, så et forsøg med en etiket ikke bliver din eneste kopi af den fungerende liste. Det gør det også lettere at sammenligne en ændring med det oprindelige indhold.
Hvad de beskrivende felter fortæller
EXTINF-linjen indeholder oplysninger, der hører til næste post. I mange IPTV-kataloger betyder varigheden minus én, at posten ikke har en kendt, fast varighed. Teksten efter kommaet er visningsnavnet. Attributterne før kommaet er konventioner, som bestemte afspillere og udbydere anvender; understøttelsen er ikke ens i alle programmer. Du bør derfor ikke forvente, at ethvert ekstra felt bliver fortolket på samme måde.
| Eksempelfelt | Formål | Hvad det ikke beviser |
|---|---|---|
tvg-id="demo.news" | En kanalidentifikator, som kan forbindes med programdata | At der findes en tilsvarende post i guiden |
group-title="Examples" | En foreslået kategori til at organisere poster | At alle afspillere behandler grupper ens |
Example News | Et læsbart kanalnavn | At streamen er tilgængelig eller licenseret |
| Den efterfølgende URL | Placeringen, der anmodes om ved afspilning | At kontoen har tilladelse til at tilgå den |
En logoadresse er, hvis den findes, endnu en ressource, som brugerfladen kan hente. Et manglende billede betyder derfor ikke nødvendigvis, at videoen er defekt. Tilsvarende er et korrekt vist logo ikke en afspilningstest. Når du adskiller navne, billeder, identifikatorer og videoens placering, bliver dine observationer mere præcise og lettere at bruge i en konkret fejlrapport.
En kanalliste kan pege på en anden liste
Det er normalt, at det ydre katalog indeholder adresser, hvis svar selv er afspilningslister. Den ydre liste fortæller, hvilken kanal seeren valgte. Et HLS-manifest kan derefter beskrive medievarianter eller rækkefølgen af små segmenter, der leverer kanalen. Det er forskellige lag, selv om begge bruger beslægtet tekstsyntaks. Kataloget behøver derfor ikke at indeholde selve oplysningerne om hvert videosegment.
En M3U8-endelse er af den grund ikke nok til at afgøre, om en URL hører til i en katalogimportør eller en medieafspiller. Sammenligningen af M3U og HLS forklarer de afgørende tags. Følg vejledningen fra din autoriserede kilde frem for at ændre filendelser, indtil importøren accepterer filen. En navneændring ændrer ikke, hvad indholdet faktisk beskriver.
Kontrollér identifikatorer, når guiden mangler
I det fiktive eksempel kan identifikatoren demo.news svare til en kanal, der er erklæret i en XMLTV-guide. Programregistreringerne henviser tilbage til guidens kanalidentifikator. Hvis kilden i stedet bruger demo.news.hd, giver lignende visningsnavne ikke nødvendigvis et match. Den præcise sammenkædning afhænger af programmet og kildens konventioner, så navnenes lighed er ikke i sig selv dokumentation for den rigtige forbindelse.
Før du redigerer identifikatorer, bør du sammenligne det katalog og den guide, der er beregnet til at fungere sammen. En regional udgave kan bruge en anden identifikator end en landsdækkende udgave med lignende navn. Omfattende erstatning af navne i en stor fil kan skabe forkerte forbindelser. Arbejd med ét forståeligt eksempel, og læs hvordan XMLTV-matching fungerer, før du ændrer hele listen.
Undersøg strukturen uden at afsløre kontoen
En URL kan indeholde loginoplysninger både i stien og efter et spørgsmålstegn. Det er ikke nok kun at skjule en parameter med navnet password. Et token, kontonummer eller en signeret adresse kan stå andre steder. Når du laver et eksempel til support, skal du erstatte hele placeringen med en reserveret eksempeladresse og beskrive svaret eller fejlmeddelelsen separat.
Upload ikke en privat afspilningsliste til et onlineværktøj til formatering eller validering, blot fordi det tilbyder en praktisk forhåndsvisning. Et hentet katalog kan afsløre samtlige streamadresser knyttet til kontoen. Gem sikkerhedskopier på lagring, du selv styrer, og overvej, hvem der har adgang til en synkroniseret mappe. Guiden til afspilningslistens privatliv indeholder en praktisk tjekliste til at skjule følsomme oplysninger.
Forstå hvad redigering kan løse
En tekstkopi kan afsløre en ufuldstændig adresse, et utilsigtet linjeskift eller en HTML-loginside gemt med M3U-endelse. Det er nyttige fund. En fil med tilsyneladende korrekt syntaks kan dog stadig pege på utilgængelige medier. Ændring af gruppenavn, identifikator eller filendelse kan ikke forny en konto, omgå en serverbegrænsning eller give tilladelse til at se indholdet.
Hvis kataloget indlæses, men én post fejler, så notér, om andre poster virker, og om fejlen følger samme autoriserede stream i en anden kompatibel opsætning. Hvis selve kataloget ikke kan importeres, skal du bevare det oprindelige svar og se vejledningen til lister, der ikke indlæses. Når strukturen er forstået, finder du de faktiske importtrin i InoxTVs M3U-vejledning.
