TaalNederlands

Artikelen

XMLTV-programmagids: hoe programma’s het juiste kanaal vinden

Begrijp XMLTV-kanaalidentificatoren, programmaverwijzingen en tijdsdekking, en waarom een geslaagde gidsdownload toch lege kanalen kan opleveren.

Gepubliceerd door InoxTV · Gepubliceerd

Laatst bijgewerkt

Een XMLTV-programmagids is een uitzendschema, geen videostream. Hij bevat kanaalbeschrijvingen en programmarecords die naar die kanalen verwijzen. Voor nuttige vermeldingen moet een speler de gidsidentificatoren koppelen aan de kanalen in je lijst en programma’s voor het juiste tijdstip selecteren. Elk onderdeel kan afzonderlijk mislukken, ook wanneer het gidsbestand succesvol wordt gedownload.

Volg één identificator door de gegevens

Het fictieve voorbeeld hieronder beschrijft een kanaal met identificator demo.news. Het programma verwijst via het channel-attribuut naar die identificator. De weergavenaam is leesbare tekst; de identificator verbindt de records. Datums, titel en kanaal dienen als voorbeeld en stellen geen echt uitzendschema voor.

<tv>
  <channel id="demo.news">
    <display-name>Example News</display-name>
  </channel>
  <programme channel="demo.news"
    start="20261102180000 +0000"
    stop="20261102183000 +0000">
    <title lang="en">Evening bulletin</title>
  </programme>
</tv>

Een bijbehorend catalogusitem kan tvg-id="demo.news" bevatten. Of en hoe een speler dat attribuut gebruikt hangt af van de implementatie en bronafspraken. Een vergelijkbare kanaalnaam is geen universele koppelregel. Het veiligste uitgangspunt is een lijst en gids die bewust samen zijn gepubliceerd, gevolgd door de beschreven configuratie van de applicatie.

Ken je catalogusattributen nog niet, lees dan eerst het toegelichte M3U-voorbeeld. Dat onderscheidt weergavenaam, gidsidentificator en streamadres, zodat je het juiste veld vergelijkt zonder de afspeellocatie te wijzigen. Zo blijft duidelijk welk gegeven alleen het programma koppelt en welk gegeven het videoadres bepaalt.

Scheid vier fasen van een update

FaseVraagVoorbeeldfout
OphalenKon de gidsbron worden opgehaald?De host was onbereikbaar
VerwerkenWas het antwoord als verwachte gegevens leesbaar?Er kwam een HTML-foutpagina in plaats van XMLTV
KoppelenZijn gidskanalen te verbinden aan lijstkanalen?Identificatoren horen bij een andere regionale uitzending
TonenZijn er programma’s voor het gekozen tijdstip?De bron bevat alleen het schema van gisteren

Statusmeldingen tonen niet noodzakelijk alle vier fasen. Een succesmelding kan betekenen dat een update zonder operationele fout is afgerond, terwijl een kanaal nog steeds leeg blijft. Beoordeel de melding samen met een specifiek kanaal en tijdsbereik. Verander de gids-URL niet voortdurend voordat redelijk duidelijk is welke fase aandacht nodig heeft.

Herken een verkeerde koppeling met een gecontroleerd voorbeeld

Kies een kanaal waarvan je het verwachte programma kunt herkennen. Noteer de exacte uitzending of regionale editie, niet alleen het merk. Vergelijk de lijstidentificator met de kanaaldefinitie en programmaverwijzingen van de gids, wanneer je die mag bekijken. demo.news en demo.news.west kunnen bijvoorbeeld verschillende uitzendingen beschrijven terwijl beide Example News tonen.

Alle identificatoren vervangen door een eenvoudige kanaalnaam kan de situatie verslechteren. Twee verschillende uitzendingen kunnen dezelfde naam krijgen, waardoor een schema aan verkeerde video hangt. Bewaar een kopie van ieder bewerkt bestand, test eerst één item en behoud de bedoelde verschillen. Een brede zoek-en-vervangactie is geen betrouwbaar alternatief voor begrijpen hoe de koppeling werkt.

Bij het fictieve verschil tussen demo.news en demo.news.west is alleen de naam gelijkmaken dus onvoldoende. Controleer eerst welke uitzending je werkelijk bekijkt en welke uitzending het programma beschrijft. Een gevuld raster kan nog steeds de verkeerde inhoud tonen. De controle is pas bruikbaar wanneer het verwachte programma ook bij de bedoelde uitzending en gekozen datum past.

Controleer het tijdsbereik naast het kanaal

Een gids kan een kanaaldefinitie bevatten zonder programma’s voor morgen. Hij kan ook maar een deel van de kanalen in een grote lijst dekken. Geen van beide betekent dat de XML onjuist is opgebouwd. Controleer het werkelijke begin en einde van de programmagegevens voordat je een leeg deel van het raster als downloadfout behandelt.

Programmatijden vragen zorgvuldige interpretatie. In het voorbeeld is +0000 een expliciete UTC-afwijking. Een andere bron kan hetzelfde moment met een andere lokale kloktijd en afwijking beschrijven. Staat het juiste programma op het verkeerde uur, onderzoek dan tijdstempels en conversie in plaats van de kanaalidentificator te wijzigen. Het artikel over EPG-tijdzones werkt die berekening uit.

Een grotere gids is niet altijd nuttiger

Een gids voor veel landen en weken kan meer geheugen, verwerking en downloadtijd vragen dan een gerichte bron. De omvang vertelt niets over de koppeling van jouw kanalen. Kies een toegestane bron met passende kanalen, voldoende tijdsdekking en een voorspelbare updateprocedure. Houd rekening met de mogelijkheden van de televisie of streamingstick die het werk werkelijk uitvoert.

Compressie kan de overdracht verkleinen, maar het apparaat moet nog steeds de uitgepakte gegevens verwerken. Een kleine gecomprimeerde download kan dus een veel grotere verwerkingslast geven. Minder geschiedenis bewaren kan bij sommige apps helpen, maar garandeert niet dat een te grote bron verwerkbaar wordt. Volg de beschreven instellingen en observeer de update in plaats van een bepaalde geheugenlimiet te veronderstellen.

Maak van waarnemingen een bruikbaar verslag

Noteer of de update succes meldt, welke kanalen zijn getroffen, de gekozen datum, de tijdzone van het apparaat en één verwacht programma. Vertel of alle vermeldingen ontbreken of slechts één uitzending fout is. Dat onderscheid helpt een verbindingsprobleem van dekking of koppeling te scheiden. Deel geen privéadressen van gidsen met accounttokens.

Voor InoxTV beschrijft de installatiehandleiding van de tv-gids waar je bronnen instelt, en de pagina over ontbrekende gidsgegevens behandelt statusmeldingen. Gebruik dit artikel om de gegevensrelatie te begrijpen en die pagina’s voor exacte interfacehandelingen. Controleer een geslaagde oplossing bij meer dan één programma en datum, zodat één toevallig passende vermelding niet je enige controle is.

Bronnen

Veelgestelde vragen

Betekent een geslaagde gidsupdate dat ieder kanaal programma’s heeft?
Nee. Een update kan geldige gegevens ophalen en verwerken die jouw kanaalidentificatoren of de bekeken periode niet bevatten. Controleer koppeling en tijdsdekking afzonderlijk van een geslaagde download.
Kunnen kanalen vergelijkbare namen maar andere schema’s hebben?
Ja. Regionale, vertraagde of verschillende edities kunnen vergelijkbare weergavenamen gebruiken en toch andere programma’s uitzenden. Vergelijk de bedoelde identificatoren en details van de uitzending.
Bevat XMLTV ook de video?
Nee. XMLTV beschrijft kanalen en programma’s. Video komt uit een aparte stream; een gidsvermelding levert geen toegangsrechten, terugkijkfunctie of opname.