Codici di stato del Player

Dove compaiono i codici

Un chip è un’icona nell’angolo in basso a sinistra dello schermo, con un messaggio di una riga quando compare per la prima volta. Il Player mostra la condizione attiva di rango più alto e mantiene il chip finché la condizione persiste. Il dashboard mostra il chip accanto allo stato online dello schermo.

screenrig screen show scr_ID restituisce ciò che il Player ha segnalato:

Un chip è l’ultimo rapporto del Player: leggilo come obsoleto finché online è false. I rapporti come player.video_unusable e player.card_failed vanno nel log del Player dello schermo:

screenrig events list --source log --screen-id scr_ID

Chip di stato

La tabella segue l’ordine di rango: quando valgono più condizioni, viene mostrata la prima. L’etichetta è il nome del chip nel dashboard.

Aggiornamento del Player necessario è un avviso accanto al chip, non un chip. Compare quando la versione del Player è inferiore al minimo supportato da screenRIG, e il Player continua a riprodurre i suoi contenuti salvati. Aggiorna il Player con screenrig screen update-software scr_ID dove dichiara update, altrimenti tramite il suo store o il gestore dei dispositivi.

Video non riproducibili

Un Player decodifica il video con il decoder hardware del dispositivo per il codec, il profilo e la risoluzione del file. Quando il dispositivo non può, il Player salta l’elemento: il chip è decode_miss, oppure decode_unplayable quando non c’è altro sullo schermo. Il record player.video_unusable del log del Player riporta il campo code (video_load_failed, video_play_failed, video_autoplay_blocked, video_stalled, image_load_failed, video_prepare_failed, video_first_frame_timeout o video_decode_failed) con i valori decoder, codecs, width e height misurati dal Player.

screenrig media upload ./lobby-loop.mp4 --codec hevc
screenrig media upload ./lobby-loop.mp4 --preset signage-1080p30

Un video viene caricato come H.264 per impostazione predefinita. Un Raspberry Pi 5 non ha un decoder H.264: carica ogni video per esso con --codec hevc, qualunque sia la dimensione. Un Raspberry Pi 4 riproduce 1080p, e --preset signage-1080p30 limita la dimensione. Usa hevc solo quando ogni schermo che riproduce la clip è un Player nativo. Sostituisci il media nella playlist e pubblicala di nuovo.

L’assegnazione di una playlist i cui video sono tutti H.264 a uno schermo il cui Player dichiara video.h264_unavailable viene rifiutata con invalid_request. Nei contenuti misti quel Player salta gli elementi H.264.

Errori di pagina e di aggiornamento

Una pagina che non riesce a diventare pronta viene saltata e il Player continua a riprodurre le altre pagine. Segnala l’errore, e last_page_failure.code è il codice proprio del Player. screenrig events list --type playback.page_failed --screen-id scr_ID li elenca.

manifest_upgrade.state indica come procede un aggiornamento dei contenuti:

manifest_upgrade.code indica la causa di uno stato retrying, failed, blocked o partial:

Cache e archiviazione

Prima di scaricare una revisione, un Player pianifica la propria archiviazione: quali file delle pagine rientrano nello spazio che può usare. Un Player nativo lascia liberi 128 MiB del proprio volume e rimane entro l’eventuale quota impostata per esso. All’avvio, un Player con meno di 512 MiB liberi mostra un messaggio con lo spazio libero; quel messaggio non è un chip.

storage.plan.fit in screen show indica come la playlist rientra nello spazio disponibile:

manifest_upgrade.code ripete il piano: none_fit o transition_blocked per un aggiornamento blocked, capacity per un aggiornamento partial le cui pagine non rientravano nello spazio, staged per un aggiornamento partial che si sta ancora riempiendo e storage_full quando una scrittura non riesce. storage_shortfall è presente finché fit è partial, transition_blocked o none_fit.

Ogni voce di excluded_pages contiene reason:

Chiedi prima di assegnare una playlist di grandi dimensioni:

screenrig screen storage-forecast scr_ID --playlist-id pl_ID

Risponde con fits, partial, none_fit o unknown, con i byte necessari alla playlist e la capacità del Player. unknown indica che lo schermo non ha mai segnalato l’archiviazione. Un rapporto più vecchio di 24 ore è contrassegnato come obsoleto. Il comando non scrive nulla. Quando compare un errore di archiviazione, la risposta contiene un avviso storage_full: libera spazio sul dispositivo che esegue il Player, poi riprova con la playlist.

Schede

Una scheda che non può essere disegnata lascia vuoto il suo rettangolo e la pagina continua a essere riprodotta. Il Player registra card.failed, e i Player web, Android e Windows segnalano player.card_failed una volta per ogni scheda in una pagina e per ogni codice, con page_id, primitive_id, manifest_revision e code. Anche una scheda i cui dati sono scaduti resta vuota: screenrig card data put --ttl 30m la rinnova.