Agenda, risultati e notizie dalla vostra fonte — pagine della guida automatica

Oltre alla pagina «Ora su …», la guida automatica può creare pagine dai vostri dati: un'agenda con gli eventi in arrivo, i risultati per competizione e le notizie — ciascuna da un indirizzo JSON che legge da sola ogni pochi minuti. Castreon disegna la pagina in tempo reale, e va in onda come qualsiasi canale (HLS, HTTP-TS, push, DRM) o come blocco nel palinsesto di un canale da file.

Disponibile da Castreon 2.1.0, nell'edizione Enterprise.

I tre tipi

• Agenda — gli eventi in arrivo, 3–5 per pagina: il giorno («OGGI», «DOMANI», «GIOVEDÌ 29.10»), l'ora grande, l'etichetta della competizione, il titolo e l'etichetta del canale (immagine + due righe). Il primo evento è evidenziato; un evento che inizia a breve mostra «tra 45 min», uno in corso «in diretta ora».
• Risultati — le partite raggruppate per competizione, 4 per colonna, 2 colonne per pagina: squadra di casa, il punteggio su una targa nel colore d'accento, squadra ospite e sotto il punteggio lo stato — «LIVE 67'», «INTERVALLO», «FINALE», l'ora d'inizio o «RINVIATA».
• Notizie — una notizia per pagina: l'etichetta, il titolo grande su 1–2 righe, il testo su al massimo 3 righe, la fonte e l'ora.

Le pagine cambiano da sole dopo i secondi scelti. I testi fissi («OGGI», «FINALE», «INTERVALLO» ecc.) sono nella lingua della guida: rumeno, inglese, tedesco, italiano o spagnolo.

La fonte (formato JSON)

L'indirizzo deve restituire JSON: un oggetto con l'elenco items o direttamente l'elenco. Gli orari sono in formato RFC 3339, con fuso orario (senza fuso = quello della guida).

Agenda — start e title sono obbligatori; senza end, un evento dura 2 ore:

{"items": [
  {"start": "2026-11-02T21:45:00+02:00", "end": "2026-11-02T23:45:00+02:00",
   "category": "Calcio · Champions League", "title": "Squadra A – Squadra B", "channel": "Sport 1"}
]}

Risultati — una riga per partita; status può essere live, halftime, final, upcoming o postponed (più le abbreviazioni usuali dei fornitori di dati: FT, HT, NS, PST…); minute è il minuto di gioco durante il live:

{"items": [
  {"competition": "Calcio · Campionato", "home": "Squadra A", "away": "Squadra B",
   "home_score": 2, "away_score": 1, "status": "live", "minute": 67}
]}

Notizie — title è obbligatorio, il resto facoltativo; al massimo 12 notizie, nell'ordine della fonte:

{"items": [
  {"category": "Calcio", "title": "…", "text": "…", "time": "2026-11-02T18:20:00+02:00", "source": "Redazione"}
]}

Se la fonte richiede una chiave, inseritela in Chiave della fonte: Castreon la invia come Authorization: Bearer …. La chiave è conservata separatamente dalla configurazione e non compare più dopo il salvataggio (né nell'API né nel registro); vuoto al salvataggio = resta quella salvata.

Castreon rilegge la fonte ogni Rilettura secondi (60–3600, predefinito 300). Se la fonte non risponde, restano sullo schermo gli ultimi dati letti; nell'editor, l'errore della fonte si vede nell'anteprima.

Usate solo dati che avete il diritto di mostrare: punteggi e notizie arrivano di solito da un fornitore di dati o da una redazione, con proprie condizioni d'uso.

Una guida da una fonte

Impostazioni → Guida automatica → Nuova guida, in Tipo scegliete Agenda, Risultati o Notizie, poi:

1. Nome, Titolo della pagina, Testo sopra il titolo (la riga piccola nel colore d'accento), Lingua, Fuso orario e la sua etichetta.
2. Indirizzo della fonte (JSON), Chiave della fonte (facoltativa) e Rilettura.
3. Per l'agenda: Eventi per pagina (3–5), «Tra N min» (i minuti in cui un evento è annunciato con «tra …»; 0 = mai) e Etichette dei canali: per ogni valore channel della fonte, un'immagine caricata dall'editor, due righe di testo e il colore dell'etichetta della competizione.
4. Immagine di sfondo (PNG o JPEG 16:9, ideale 1920×1080; senza immagine lo sfondo è fatto dai colori), Colori (sfondo scuro e un gradiente d'accento), Musica (facoltativa) e Testo senza eventi.

Anteprima legge subito la fonte e mostra la prima pagina.

In onda, tra i programmi di un canale

La guida va in onda tramite un canale con la sorgente Guida automatica e un'uscita HTTP-TS. Un canale da file può metterla tra i suoi file con blocchi che si ripetono nel palinsesto: per esempio, su un canale con un file d'attesa di 2 minuti in loop, tre blocchi di presa in diretta, 1 minuto ogni 9 minuti:

I blocchi possono stare nella stessa finestra (00:00–24:00), sfalsati: Castreon verifica le sovrapposizioni in base ai minuti in cui vanno davvero in onda.

Problemi frequenti

• L'anteprima dice «la fonte degli eventi risponde con il codice 401» — la fonte richiede una chiave: compilate Chiave della fonte.
• La pagina mostra il testo senza eventi — la fonte non ha nulla in arrivo (agenda) o l'elenco è vuoto; controllate l'indirizzo nel browser.
• Il blocco nel palinsesto mostra il fotogramma di pausa — il canale della guida non ha l'uscita HTTP-TS o non è in esecuzione; la finestra del blocco vi avvisa.
• Il testo si legge male — lo sfondo deve essere scuro (per esempio #0A0F1E) e l'accento un colore chiaro.