Feed della Visual Radio

L’overlay della Visual Radio legge ogni pochi secondi un piccolo JSON con il messaggio da mostrare. Se vuoi un overlay con una grafica tua (ad esempio un titolo animato in vMix, CasparCG o un programma di regia), puoi leggere lo stesso JSON.

Il feed risponde solo se la radio ha attivo Messaggi degli ascoltatori in sovrimpressione nella Visual Radio in Gestisci Radio.

La richiesta

GET https://pannello.example.it/public/visualradio/feed.php?radio=radioesempio

radio è il codice della radio (codename) oppure il suo numero. Non serve una chiave: il feed contiene solo quello che andrebbe comunque in onda.

La risposta

{
  "enabled": true,
  "autoplay": true,
  "message": {
    "key": "a1234",
    "author": "Giulia",
    "text": "Ciao a tutto lo studio, mi mettete una canzone per la mia classe?",
    "source": "whatsapp",
    "age": 42
  }
}

Campo	Contenuto
`enabled`	`false` se la radio non esiste, è disabilitata o non ha l’overlay attivo. In quel caso `message` è sempre `null`.
`autoplay`	Lo stato del pulsante Autoplay Visual nella pagina Richieste.
`message`	Il messaggio da mostrare adesso, oppure `null`.
`message.key`	Cambia a ogni nuovo messaggio da mostrare, anche quando la stessa richiesta viene rimandata in onda: confrontala con l’ultima mostrata per sapere se c’è qualcosa di nuovo.
`message.author`	Il nome di chi ha scritto, al massimo 40 caratteri. Se il nome manca, è un numero di telefono o contiene parole bloccate, vale `Ascoltatore`.
`message.text`	Il testo del messaggio, su una sola riga.
`message.source`	Da dove arriva: `web` (sito o modulo della radio), `whatsapp` oppure `sms`.
`message.age`	Secondi dall’arrivo del messaggio (con l’autoplay) o da quando è stato mandato in onda dalla pagina Richieste (senza autoplay). Usalo per non mostrare messaggi vecchi quando l’overlay si avvia.

Quale messaggio arriva

Con l’autoplay attivo: l’ultimo messaggio arrivato negli ultimi 10 minuti che supera il filtro di moderazione (parolacce, bestemmie, insulti, link e numeri di telefono).
Con l’autoplay spento: l’ultimo messaggio mandato in onda con il pulsante accanto alla richiesta nella pagina Richieste.

I messaggi vocali non arrivano mai, e il numero di chi scrive non è mai nel feed.

Consigli

Controlla il feed ogni 15 secondi circa, come fa l’overlay del pannello (tra 5 e 60 secondi va bene). La risposta non va tenuta in cache.
Il feed non ha intestazioni CORS: leggilo da un programma o da un server, oppure da una pagina servita dal pannello stesso. Una pagina web su un altro dominio non può leggerlo dal browser.
Se ti basta cambiare colori e tempi, usa i parametri dell’overlay già pronto: Personalizzare l’overlay.