Come implementare un digital signage headless che il tuo agente gestisce

In una configurazione headless il piano di controllo è un’API, non una pagina web. Il tuo agente, uno script o un job di CI effettua le stesse chiamate che una persona farebbe nella dashboard, tramite la CLI, l’API REST o il server MCP remoto. Il Player su ogni schermo scarica ciò che deve riprodurre, lo riproduce dalla memoria locale e riferisce: cosa sta mostrando, il suo stato di salute e quali controlli supporta il dispositivo. La dashboard resta a disposizione di chi la vuole; nulla dipende dal fatto che sia aperta. Digital signage headless spiega il modello, e la pagina dell’API copre ogni interfaccia.

Per un agente AI, incolla una frase e lui installa il plugin ufficiale di screenRIG, che include la skill e la CLI screenrig. Alla prima esecuzione si registra: crea la tua organizzazione e il tuo progetto e ti invia un invito via email. Guida rapida riporta la frase e i comandi di installazione per ogni agente.

In alternativa, un client MCP come Claude, ChatGPT o Grok può collegarsi al server MCP remoto: una persona lo approva nella dashboard e sceglie per esso Solo lettura, Proponi o Gestisci. Solo lettura basta a un agente che si limita a osservare, come nella sessione qui sopra. Il plugin aggiunge i passaggi che vengono eseguiti sul tuo computer, come la conversione dei media e l’impacchettamento delle app. Collega un client MCP riporta l’indirizzo del server e come accedere.

Per uno script, un job di CI o un tuo servizio, crea un client di servizio con il solo accesso che gli serve:

screenrig service-client create --name "rollout-pipeline" --access manage

Un client Solo lettura è adatto a un’attività di monitoraggio, mentre le modifiche di un client Proponi attendono la revisione di una persona. Client di servizio spiega l’accesso con una chiave o con un segreto.

Scegli dispositivi che si avviano da soli e che puoi riparare da remoto. Un Raspberry Pi o un PC Linux con installazione kiosk, un player BrightSign, un PC Windows o un dispositivo Android gestito possono tutti riavviarsi su richiesta; gli stick e le app per TV costano meno ma non possono. Come scegliere un player di digital signage li confronta, e Download elenca ogni dispositivo.

Un codice di associazione va bene per uno schermo. Per dieci, un link flotta è un solo URL del Player che trasforma ogni dispositivo che lo apre in uno schermo a sé nel tuo progetto, con i tag, i campi e la playlist del link, senza nessun codice da leggere ad alta voce.

screenrig fleet-links create --name "Kitsilano counters" --tag Kitsilano --tag Counter --playlist-id pl_MENU --max-screens 6 --expires-at 2026-11-30T23:59:59Z

La risposta contiene l’URL. È una credenziale che crea schermi, quindi consegnala solo alla configurazione del dispositivo, mai a una pagina o a una chat. Poi mettila dove il dispositivo la troverà:

• Raspberry Pi e Linux. Esegui l’installer in modalità kiosk con il link: curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk --fleet-link URL. Il dispositivo si avvia poi direttamente nel Player, entra nel progetto e riparte da solo dopo un’interruzione di corrente.
• Android, Google TV e Amazon Signage Stick. Imposta la chiave fleet_link nella configurazione gestita dell’app nel tuo gestore dei dispositivi (pacchetto ai.screenrig.player).
• Un dispositivo Android 10 o successivo, ripristinato ai dati di fabbrica e dotato di fotocamera. Scansiona il codice QR Android device owner del link dalla schermata di benvenuto. Il Player gestito si installa da solo come app Home del dispositivo, a schermo intero, senza bisogno di un gestore dei dispositivi.
• Mac, Apple TV, iPhone e iPad. Imposta fleet_link nella configurazione app gestita del tuo MDM.
• ChromeOS. Inserisci il link nell’URL dell’app kiosk nella console di amministrazione Google.

--max-screens e --expires-at impediscono a un link trapelato di creare schermi all’infinito; gli schermi già creati continuano a riprodurre. Un dispositivo ripristinato con powerwash o reinstallato torna come lo stesso schermo quando la sua vecchia identità è rimasta in silenzio per dieci minuti. La guida ai Player riporta le impostazioni di ogni gestore dei dispositivi.

Le programmazioni seguono il fuso orario di ciascuno schermo: impostalo, poi indica agli schermi quando devono essere accesi:

screenrig screen set-timezone scr_KITS_COUNTER_1 --timezone America/Vancouver
screenrig screen display-schedule set --tag Window --file store-hours.json

La programmazione del display gira sul player, quindi lo schermo si spegne all’orario di chiusura anche se internet nel negozio non funziona. I player che lo supportano comandano la TV stessa tramite HDMI-CEC, DDC/CI o la retroilluminazione; gli altri oscurano l’immagine. Vedi HDMI-CEC per il digital signage. Con ogni piano, una programmazione dei riavvii riavvia i dispositivi in una fascia tranquilla, ad esempio "Mon-Sun 04:00-04:30".

Un agente pubblica a partire da una frase. Da codice, screen publish crea una playlist da un file preparato, la assegna e attende che il Player segnali di mostrarla:

screenrig screen publish scr_KITS_COUNTER_1 menu.json
screenrig screen screenshot --tag Kitsilano --output shots/

Un’assegnazione non è una prova di riproduzione, quindi la pubblicazione attende il Player, e uno screenshot mostra cosa c’è sullo schermo. Le modifiche alla flotta passano per tag o cartella, e un’azione di flotta è una richiesta indipendentemente da quanti schermi raggiunge. Una scrittura può portare un controllo di revisione (--expect-rev), così due autori non si sovrascrivono in silenzio.

Ogni progetto parte con un’email al suo proprietario quando uno schermo è offline da 10 minuti. Aggiungi le condizioni che ti interessano:

screenrig notifications create --email owner --conditions screen_offline,display_disconnected,not_playing,glass_blank,glass_frozen --tag Kitsilano

Le notifiche controllano anche un dispositivo che si surriscalda, l’archiviazione piena, un aggiornamento dei contenuti bloccato, un Player che continua ad andare in arresto anomalo e una playlist che ha smesso di avanzare. Email e webhook firmati sono inclusi in ogni piano; l’instradamento verso Slack, Teams, PagerDuty o Telegram è incluso in Plus. Per un agente che reagisce da solo, screenrig events follow trasmette in streaming gli eventi del progetto, e gli eventi degli schermi sono gratuiti sul flusso di ascolto.

Ogni Player riporta il proprio stato di salute ogni quindici minuti e subito quando cambiano la connessione al display o l’alimentazione: uptime, memoria, temperatura dove il dispositivo la fornisce, rete e arresti anomali. screen show lo restituisce insieme alle capacità del dispositivo host dello schermo, così l’agente sa cosa può fare uno schermo prima di provarci.

Quando uno schermo si guasta, l’agente procede dalla soluzione più economica in su e usa solo ciò che quel Player dichiara:

1. Guarda. screen show riporta l’ultima interruzione dello schermo e, quando un report di salute la determina, una causa probabile: un riavvio del dispositivo, un arresto anomalo dell’app, la rete o screenRIG. Uno screenshot mostra cosa c’è sullo schermo.
2. Ricarica. screen reload aggiorna i contenuti senza toccare il dispositivo.
3. Riavvia l’app o svuota la cache. screen restart-app riavvia il Player; screen clear-cache elimina i contenuti scaricati, mantiene l’associazione e li scarica di nuovo.
4. Riavvia. screen reboot riavvia il dispositivo sui Player che lo supportano. Se inviato a uno schermo offline, resta in coda fino a 24 ore e viene eseguito quando lo schermo torna online. Un riavvio richiesto da te non genera alcun avviso di offline mentre il dispositivo si riavvia.
5. Sostituisci l’hardware. Se un dispositivo si guasta, associa quello nuovo ed esegui screen replace: il nuovo dispositivo eredita nome, tag, fuso orario, playlist, programmazioni e cronologia del vecchio schermo.

Il riferimento CLI elenca ogni comando per i dispositivi e i Player che lo supportano.

• Agente collegato, oppure un client di servizio con il minimo accesso necessario
• Player scelti per il riavvio da remoto dove un intervento in loco è costoso
• Un link flotta per negozio o gruppo, con tag, una playlist, un tetto massimo di schermi e una scadenza
• Fuso orario impostato per ogni schermo
• Programmazione del display per schermi che devono restare spenti fuori orario
• Prima pubblicazione verificata con uno screenshot da ogni schermo
• Notifiche per offline, display scollegato, mancata riproduzione e immagine nera o bloccata
• Una persona designata che riceve gli avvisi

Mi serve davvero la dashboard?

No. Tutto ciò che c’è in questa guida funziona dall’agente, dalla CLI o dall’API. La dashboard è un client in più, utile quando una persona vuole dare un’occhiata.

Posso mettere in funzione gli schermi senza leggere i codici di associazione?

Sì. Un link flotta registra ogni dispositivo che lo apre, da un gestore dei dispositivi, da un flag dell’installer Linux o da un codice QR Android.

Cosa succede quando in un negozio cade internet?

I Player nativi continuano a riprodurre ciò che hanno scaricato e le programmazioni del display continuano a funzionare sul dispositivo. Ricevi una notifica di offline quando lo schermo è rimasto offline per il tempo di attesa che hai impostato.

Quanto costa un rollout?

screenRIG è gratuito, con schermi illimitati su Standard. Vedi prezzi per ciò che aggiungono i piani a pagamento.

• screenrig.ai/docs/start
• screenrig.ai/docs/players
• screenrig.ai/docs/cli
• screenrig.ai/docs/service-clients