Articoli
Guida XMLTV: come i programmi trovano il canale corretto
Comprendi identificatori XMLTV, riferimenti dei programmi e copertura del palinsesto, e scopri perché un download riuscito può lasciare la guida vuota.
Pubblicato da InoxTV · Pubblicato
Ultimo aggiornamento
Una guida elettronica XMLTV è un palinsesto, non un flusso video. Contiene descrizioni dei canali e record dei programmi che si riferiscono a quei canali. Per mostrare informazioni utili, il lettore deve associare gli identificatori della guida ai canali della playlist e selezionare i programmi che coprono il momento pertinente. Questi passaggi possono fallire indipendentemente anche quando il file della guida viene scaricato correttamente.
Segui un identificatore attraverso i dati
L’esempio fittizio seguente dichiara un canale con identificatore demo.news. Il programma rimanda a quell’identificatore tramite l’attributo channel. Il nome visualizzato è testo leggibile; l’identificatore è il riferimento che collega i record. Date, titolo e canale sono illustrativi e non rappresentano un palinsesto reale.
<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>
Una voce corrispondente nel catalogo potrebbe riportare tvg-id="demo.news". Se e come un lettore utilizza quell’attributo dipende dalla sua implementazione e dalle convenzioni della sorgente. Un nome di canale simile non è una regola universale di associazione. Il punto di partenza più sicuro è una playlist e una guida pubblicate per funzionare insieme, seguite dalla configurazione documentata dell’app.
Se non conosci gli attributi del catalogo, leggi prima l’esempio M3U commentato. Distingue il nome visualizzato dall’identificatore della guida e dall’indirizzo dello stream, così puoi confrontare il campo corretto senza cambiare la posizione usata per la riproduzione.
Separa quattro fasi dell’aggiornamento
| Fase | Domanda | Esempio di errore |
|---|---|---|
| Recupero | È stato possibile ottenere la risorsa della guida? | L’host non era raggiungibile |
| Lettura | La risposta era leggibile nel formato previsto? | È arrivata una pagina di errore HTML invece di XMLTV |
| Associazione | I canali della guida corrispondono a quelli della playlist? | Gli identificatori si riferiscono a un altro flusso regionale |
| Visualizzazione | Esistono programmi per l’orario selezionato? | La sorgente contiene soltanto il palinsesto di ieri |
I messaggi di stato dell’applicazione non espongono necessariamente tutte e quattro le fasi. Un messaggio di successo può indicare un aggiornamento terminato senza errori operativi, lasciando comunque un canale senza voci. Interpreta il messaggio insieme a un canale e un intervallo specifici. Non cambiare ripetutamente l’URL della guida finché non è ragionevolmente chiaro quale fase richieda attenzione.
Individua una mancata corrispondenza con un esempio controllato
Scegli un canale di cui puoi riconoscere il programma atteso. Annota il flusso o l’edizione regionale esatta, non soltanto il marchio. Confronta l’identificatore della playlist con la dichiarazione del canale nella guida e i riferimenti dei programmi, quando sei autorizzato a esaminarli. Per esempio, demo.news e demo.news.west potrebbero descrivere flussi diversi anche se entrambi mostrano Example News.
Cambiare tutti gli identificatori in nomi semplificati può peggiorare la situazione. Due flussi distinti potrebbero finire con lo stesso nome, associando un palinsesto al video sbagliato. Conserva una copia dei file modificati, prova prima una voce e mantieni le distinzioni previste dalla sorgente. Una sostituzione globale non è un’alternativa affidabile alla comprensione dell’associazione tra i record.
Controlla l’intervallo temporale oltre al canale
Una guida può dichiarare un canale senza contenere programmi per domani. Può inoltre coprire soltanto una parte dei canali presenti in una playlist ampia. Nessuna delle due situazioni significa che l’XML sia malformato. Controlla l’inizio e la fine effettivi della copertura prima di considerare una zona vuota della griglia un errore di download.
Gli orari richiedono un’interpretazione attenta. Nell’esempio, +0000 è uno scostamento UTC esplicito. Un’altra sorgente può descrivere lo stesso istante con un’ora locale e uno scostamento diversi. Se il programma corretto compare all’ora sbagliata, esamina timestamp e conversioni invece di cambiare l’identificatore del canale. L’articolo sui fusi orari EPG illustra questo calcolo.
Una guida più grande non è necessariamente più utile
Una guida che copre molti paesi e settimane di programmi può richiedere più memoria, elaborazione e tempo di download di una sorgente mirata. La dimensione non dice nulla sulla corrispondenza dei tuoi canali. Preferisci una sorgente autorizzata con i canali corretti, una copertura adeguata e un processo di aggiornamento prevedibile. Considera le capacità del televisore o dispositivo che esegue effettivamente il lavoro.
La compressione può ridurre la quantità trasferita, ma il dispositivo deve comunque elaborare i dati decompressi. Un piccolo download compresso può quindi comportare un carico molto maggiore durante la lettura. Ridurre la cronologia conservata può aiutare in alcune applicazioni, ma non garantisce che una sorgente eccessiva diventi gestibile. Segui le impostazioni documentate e osserva l’aggiornamento risultante senza presumere un limite di memoria specifico.
Trasforma le osservazioni in una segnalazione utile
Annota se l’aggiornamento indica successo, quali canali sono interessati, la data selezionata, il fuso orario del dispositivo e un programma atteso. Specifica se mancano tutte le voci o se soltanto un flusso è errato. Questa distinzione aiuta a separare un problema di connettività da uno di copertura o associazione. Non condividere URL privati della guida contenenti token dell’account.
Per InoxTV, le istruzioni di configurazione della guida TV spiegano dove impostare le sorgenti, mentre la pagina sulla guida senza dati descrive i messaggi di stato. Usa questo articolo per comprendere la relazione tra i dati, poi consulta quelle pagine per le azioni precise nell’interfaccia. Una correzione riuscita va verificata su più programmi e date.
