Report
reports show KIND genera un report (fleet_health, uptime, publishing, alerts, alert_log o proof_of_play) e, con --format csv, xlsx o pdf e --output FILE, lo scrive in un file; reports subscriptions invia un report via email ai membri del progetto secondo una programmazione; project export DIR scrive i dati del progetto con l’esito di ogni sezione. Report ed esportazioni descrive ciascuno.
reports list#
Elenca i tipi di report e i filtri di ciascuno.
reports listNessun parametro.
screenrig reports listRestituisce data.items, ciascuno con kind, title, description del report e i filtri che accetta (params), più i formats di file.
reports show#
Genera un report come righe, oppure scrivilo in un file CSV, XLSX o PDF.
reports show <kind> [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--group-by folder|screen|tag]
[--folder-id ID [--direct]] [--tag TAG] [--campaign-id ID] [--advertiser NAME]
[--format json|csv|xlsx|pdf] [--output FILE]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
<kind> | string | sì | nessuno | fleet_health, uptime, publishing, alerts, alert_log o proof_of_play. |
--from | string | no | 29 giorni prima di --to | Primo giorno UTC, incluso, come YYYY-MM-DD. |
--to | string | no | oggi | Ultimo giorno UTC, incluso; al massimo 366 giorni dopo --from. |
--group-by | string | no | folder | Che cos’è una riga: folder, screen o tag. |
--folder-id | string | no | nessuno | Solo questa cartella di schermi e tutto ciò che contiene. |
--direct | boolean | no | spento | Con --folder-id: solo gli schermi direttamente nella cartella (--group-by screen), oppure la cartella e le sue sottocartelle. |
--tag | string | no | nessuno | Solo gli schermi con questo tag. |
--campaign-id | string | no | nessuno | proof_of_play: una campagna diretta. |
--advertiser | string | no | nessuno | proof_of_play: le campagne di questo inserzionista o sponsor, per nome esatto, senza distinzione tra maiuscole e minuscole. |
--format | string | no | json | json, csv, xlsx o pdf. |
--output | path | no | ./KIND.FORMAT | File da scrivere con --format csv, xlsx o pdf. Per impostazione predefinita il tipo è scritto con i trattini, come ./fleet-health.pdf, e viene aggiunto il giorno di --to se indicato, come ./fleet-health-2026-10-28.pdf. |
screenrig reports show fleet_health --group-by screen --from 2026-10-01 --to 2026-10-28
screenrig reports show proof_of_play --advertiser "Acme Corp" --format pdf --output acme-proof-of-play.pdfIl JSON restituisce data.columns, data.rows, data.totals e data.notes; le righe di un report per cartella portano id, parent_id e depth per la struttura, e la prima riga è l’intero progetto. Un file risponde con percorso, byte e SHA-256. Un report paginato viene scritto per intero, fino a 50000 righe (altrimenti data.truncated). proof_of_play richiede un progetto che vende tempo pubblicitario sui propri schermi. Basta l’accesso Solo lettura con la capacità reports.
reports subscriptions#
Invia un report via email ai membri del progetto secondo una programmazione.
reports subscriptions list
reports subscriptions show <id>
reports subscriptions create --name NAME --kind KIND --format pdf|xlsx|csv
--recipients MEMBERS --cadence daily|weekly|monthly [--weekday DAY]
[--day-of-month N] [--hour N] [--timezone ZONE] [--filter NAME=VALUE]
reports subscriptions update <id> [--name NAME] [--format pdf|xlsx|csv]
[--recipients MEMBERS] [--filter NAME=VALUE] [--cadence daily|weekly|monthly]
[--weekday DAY] [--day-of-month N] [--hour N] [--timezone ZONE]
[--pause | --resume] [--expect-rev REVISION]
reports subscriptions delete <id>
reports subscriptions send <id>| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
<id> | string | sì | nessuno | L’ID rsub_ di un abbonamento, da reports subscriptions list. |
--name | string | in creazione | nessuno | Al massimo 100 caratteri. |
--kind | string | in creazione | nessuno | Un tipo di reports show: fleet_health, uptime, publishing, alerts, alert_log o proof_of_play. Non cambia mai. |
--format | string | in creazione | nessuno | L’allegato: pdf, xlsx o csv. |
--recipients | string | in creazione | nessuno | Fino a 25 membri del progetto, separati da virgole: un ID utente, l’indirizzo email di un membro o owner. update sostituisce i destinatari. |
--filter | string | no | nessuno | Un filtro del report come NAME=VALUE, ad esempio group_by=screen, folder_id=sfd_ID, tag=Lobby o advertiser=Acme; ripetibile. update sostituisce i filtri. |
--cadence | string | in creazione | nessuno | daily, weekly o monthly. |
--weekday | string | no | monday | Esecuzioni settimanali: da monday a sunday. |
--day-of-month | integer | no | 1 | Esecuzioni mensili: il giorno, da 1 a 28. |
--hour | integer | no | 0 | Ora del giorno nel fuso orario, da 0 a 23. |
--timezone | string | no | UTC | Un fuso orario IANA come America/Los_Angeles. |
--pause | boolean | no | spento | Solo update: non invia nulla finché non viene ripreso. Non insieme a --resume. |
--resume | boolean | no | spento | Solo update: riprende l’invio dalla prossima occorrenza. |
--expect-rev | integer | no | nessuno | Solo update: fallisce se l’abbonamento non è a questa revisione. |
screenrig reports subscriptions create --name "Monday fleet health" --kind fleet_health --cadence weekly --weekday monday --hour 7 --timezone America/Los_Angeles --format pdf --recipients ann@example.com,usr_01EXAMPLEPERSON0000
screenrig reports subscriptions update rsub_01EXAMPLESUB0000000000 --pauseOgni esecuzione copre il periodo che la precede in giorni UTC: ieri, i sette giorni precedenti o il mese scorso. I destinatari devono essere membri del progetto, e un membro che se ne va smette di ricevere il report. update richiede almeno una modifica. send invia il report ora per il periodo che un’esecuzione coprirebbe ora, senza spostare la pianificazione, e risponde con l’abbonamento, inclusi last_status e last_error di questo invio. Un’esecuzione non riuscita viene ritentata e compare come last_status failed con last_error; un allegato PDF o XLSX oltre 8 MiB non viene inviato. Un’organizzazione ha al massimo 50 abbonamenti tra tutti i suoi progetti. La lettura richiede la capacità project e l’accesso Solo lettura; creare, modificare, eliminare e inviare richiedono l’accesso Gestisci.
Registro di audit
audit list|show|head|verify|export legge il registro di audit del progetto: audit list cerca le modifiche di configurazione per attore, origine, risorsa, azione e campo, audit show mostra una voce con il prima e il dopo di ogni campo modificato, audit head mostra la testa della catena da conservare come ancora, audit verify ricalcola la catena (se si vuole rispetto a un’ancora) e termina con il codice 13 quando non risulta verificata, e audit export scrive il registro filtrato in un file CSV, XLSX o PDF. Registro di audit descrive ciascuno di essi.
audit list#
Elenca le voci di audit, le più recenti per prime.
audit list [--actor ID] [--actor-kind KIND] [--source SOURCE] [--resource-type TYPE]
[--resource-id ID] [--action CODE] [--field POINTER] [--since TIME] [--until TIME]
[--limit N] [--after CURSOR]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--actor | string | no | nessuno | Solo le modifiche fatte da questa persona, agente o client di servizio, in base al suo ID. |
--actor-kind | string | no | nessuno | person, agent, service_client, staff o system. |
--source | string | no | nessuno | La superficie attraverso cui è arrivata una modifica: dashboard, api, cli, device, webhook o system. |
--resource-type | string | no | nessuno | Solo le modifiche a questo tipo di risorsa, come screen, playlist, webhook o member. |
--resource-id | string | no | nessuno | Solo le modifiche a questa risorsa. |
--action | string | no | nessuno | Un codice azione come screen.update, o un prefisso che termina con * come playlist.*. |
--field | string | no | nessuno | Solo le modifiche che hanno toccato questo membro o uno sottostante, come puntatore JSON, ad esempio /label. |
--since | string | no | nessuno | Solo le modifiche a partire da questo istante RFC 3339, come 2026-10-01T00:00:00Z. |
--until | string | no | nessuno | Solo le modifiche precedenti a questo istante RFC 3339. |
--limit | integer | no | 50 | Voci per pagina, da 1 a 200. |
--after | string | no | nessuno | Il data.next_cursor della pagina precedente. |
screenrig audit list --resource-type screen --resource-id scr_01EXAMPLESCREEN00000000
screenrig audit list --action 'playlist.*' --source cli --limit 20Restituisce data.items dal più recente, ciascuno con actor (kind, id, name), source, action, resource (type, id, name) e changes, ciascuno con un path (un puntatore JSON nella risorsa), before e after; una credenziale appare come (redacted) su entrambi i lati. seq e hash compaiono quando una voce viene concatenata, entro pochi secondi. data.next_cursor è null sull’ultima pagina. Basta l’accesso Solo lettura con la capacità project.
audit show#
Mostra una voce di audit con il prima e il dopo di ogni campo modificato.
audit show <id>| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
<id> | string | sì | nessuno | L’ID aud_ di una voce, da audit list. |
screenrig audit show aud_01EXAMPLEENTRY0000000000Restituisce la voce con path, before e after di ogni campo modificato, chi ha fatto la modifica e tramite quale superficie, e la sua posizione nella catena una volta concatenata.
audit head#
Mostra la testa della catena di audit da conservare come ancora.
audit headNessun parametro.
screenrig audit headStampa l’ultima voce concatenata come SEQ:HASH, il limite di conservazione da cui parte la catena e quante voci attendono di essere concatenate. Conserva la testa: audit verify --anchor SEQ:HASH dimostra poi che la cronologia non è stata riscritta né troncata.
audit verify#
Ricalcola la catena di hash di audit e segnala tutto ciò che non corrisponde.
audit verify [--from-seq N] [--limit N] [--anchor SEQ:HASH]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--from-seq | integer | no | voce più vecchia conservata | Prima posizione della catena da verificare. |
--limit | integer | no | 5000 | Voci da verificare in questa chiamata, al massimo 5000. |
--anchor | string | no | nessuno | Una testa della catena SEQ:HASH che hai conservato: dimostra anche che la cronologia fino a essa non è cambiata. |
screenrig audit verify --anchor 128:3f2c0b6e9a4d81c7f5e0a2b4c6d8e0f1a3b5c7d9e1f30415263748596a7b8c9dSegnala hash_mismatch, prev_mismatch, gap, head_mismatch, anchor_mismatch o floor_mismatch per voce in data.problems. Termina con il codice 13 e data.ok false quando la catena non risulta verificata; data.next_seq prosegue una catena più lunga.
audit export#
Scrive il registro di audit filtrato in un file CSV, XLSX o PDF.
audit export --format csv|xlsx|pdf [--output FILE]
[--actor ID] [--actor-kind KIND] [--source SOURCE] [--resource-type TYPE]
[--resource-id ID] [--action CODE] [--field POINTER] [--since TIME] [--until TIME]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--format | string | sì | nessuno | csv, xlsx o pdf. |
--output | path | no | ./audit-log.FORMAT | File da scrivere. Con --until il nome predefinito aggiunge quel giorno, come ./audit-log-2026-10-01.csv. |
--actor, --actor-kind, --source, --resource-type, --resource-id, --action, --field, --since, --until | string | no | nessuno | I filtri di audit list. Senza --since il file copre gli ultimi 30 giorni. |
screenrig audit export --format csv --output audit.csv
screenrig audit export --format pdf --resource-type playlist --output playlist-changes.pdfScrive una riga per campo modificato, dalla più vecchia, fino a 50000 righe (altrimenti data.truncated), con la testa della catena e il limite di conservazione nel file, e risponde con percorso, byte e SHA-256.
Riproduzione
Le prove di riproduzione hanno quattro forme. playback plays legge una riga per ogni inizio visibile di immagine, video o applicazione su uno schermo, dal più vecchio per received_at: prova di riproduzione per un report o un inserzionista. playback list legge totali giornalieri, una riga per schermo, oggetto media e giorno UTC. playback totals legge conteggi di riproduzione per giorno UTC, o classifica gli schermi o media più attivi. playback completeness legge quante delle riproduzioni numerate dai Player sono arrivate a screenRIG, e dove mancano riproduzioni.
Ogni comando playback accetta --format json|csv|xlsx|pdf e --output FILE, e il dashboard esporta gli stessi file. json, il valore predefinito, è la busta del comando e rifiuta --output; gli altri formati scrivono un file. playback plays e playback list trasmettono in streaming il proprio CSV, e --output - lo invia a stdout invece della busta. Ogni altro file viene generato sul server e salvato in un percorso di file. Un file xlsx o pdf contiene al massimo 50.000 righe per playback plays e al massimo 200 per playback list. Ogni comando indica il proprio file predefinito.
Le riproduzioni sono conservate per il periodo di conservazione degli eventi previsto dal piano, e comunque per almeno 30 giorni.
| Codice problema | Esci | Significato |
|---|---|---|
invalid_request | 8 | Un intervallo di riproduzioni più lungo di 31 giorni, un intervallo giornaliero oltre il limite del comando, o un filtro malformato. La CLI rifiuta la maggior parte di questi prima di inviare (exit 2). |
rate_limited | 7 | Il budget di esportazione riproduzione di 30 richieste al minuto per organizzazione è esaurito. Attendere retry_after_seconds. |
Richieste agente: ogni pagina JSON è una richiesta agente, quindi --all fa una richiesta per pagina. Un’esportazione CSV è una richiesta per l’intero intervallo. Ogni richiesta di riproduzioni (una pagina JSON, CSV, XLSX o PDF) e ogni esportazione CSV di playback list consuma anche il budget di esportazione delle riproduzioni. playback totals e playback completeness sono una richiesta agente ciascuno e non consumano nulla di quel budget.
playback plays#
Leggi i record di riproduzione per ogni riproduzione, una riga per ogni inizio visibile.
playback plays [--from TIME] [--to TIME] [--screen-id ID] [--media-id ID] [--tag TAG] [--cursor CURSOR] [--limit N] [--all]
playback plays --format csv|xlsx|pdf [--output FILE] [--from TIME] [--to TIME] [--screen-id ID] [--media-id ID] [--tag TAG]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--from TIME | string | no | 24 ore prima di --to | Limite inclusivo su received_at: un istante RFC 3339 con secondi e offset, now, o un’età come 7d, 12h o 30m. |
--to TIME | string | no | ora | Vincolo esclusivo, nelle stesse forme. L’intervallo è al massimo di 31 giorni. |
--screen-id ID | string | no | ogni schermo | Uno schermo scr_. |
--media-id ID | string | no | ogni oggetto | Un oggetto media med_. |
--tag TAG | string | no | ogni schermo | Un tag che lo schermo aveva quando la riproduzione è stata ricevuta: da 1 a 32 lettere o cifre. |
--cursor CURSOR | string | no | l’inizio dell’intervallo | Il next_cursor della pagina precedente (pc_…), con gli stessi filtri. |
--limit N | integer | no | 200 | Righe per pagina JSON, da 1 a 1000. Solo JSON: --format csv lo rifiuta. |
--all | boolean | no | spento | Segui il cursore fino alla fine dell’intervallo, 1000 righe per pagina salvo diversa indicazione in --limit; massimo 50 pagine. Solo JSON: --format csv lo rifiuta. |
--format FORMAT | string | no | json | json, csv, xlsx o pdf. csv trasmette in streaming l’intero intervallo; xlsx e pdf ne contengono le prime 50.000 righe. |
--output FILE | path | no | ./playback-plays.csv, ./plays.xlsx o ./plays.pdf | Il file da scrivere; richiede un formato file. Con --format csv, - scrive il CSV su stdout invece della busta. |
screenrig playback plays --from 7d --tag Lobby --all
screenrig playback plays --format csv --from 2026-09-01T00:00:00Z --to 2026-10-01T00:00:00Z --output september-plays.csv
screenrig playback plays --format xlsx --from 7d --tag Lobby --output lobby-plays.xlsxLa CLI normalizza entrambi i limiti in UTC e li invia a ogni richiesta; data.from e data.to li ripetono. Gli ultimi 5 secondi sono trattenuti finché si stabilizzano, quindi una riproduzione appare circa 5 secondi dopo la ricezione, e data.to riporta tale fine effettiva. Una riproduzione di applicazione porta release_id e un media_id vuoto. Il JSON restituisce una pagina in data.items con data.next_cursor, e data.next.argv è il comando esatto per la pagina successiva. --all si ferma prima, con data.next e un avviso, al limite di pagine (playback_plays_truncated) o quando il budget di esportazione è esaurito (playback_export_rate_limited), invece di sprecare richieste in un rifiuto.
Il CSV è conforme a RFC 4180 con la riga di intestazione fissa screen_id,playlist_id,page_id,primitive_id,media_id,primitive,started_at,received_at,manifest_revision,playlist_revision, orari in RFC 3339 UTC. primitive_id e started_at sono vuoti a meno che il Player non li abbia segnalati. Una cella che inizia con =, +, -, @, tabulazione o ritorno a capo ha un ' iniziale per evitare che i fogli di calcolo la valutino. La CLI scrive tramite un file temporaneo privato nella stessa cartella e sostituisce un file esistente solo dopo che il flusso termina correttamente. --timeout è il limite di inattività per il flusso, 60000 ms senza byte di default, non un limite sulla durata totale. La busta riporta path, bytes, rows, sha256, content_type, from, to e last_received_at; il CSV non entra mai nella busta. Con --output - il CSV va su stdout e non viene stampata alcuna busta.
Se uno stream fallisce a metà, il comando esce con codice non zero e non scrive mai il file di destinazione. Le righe complete già ricevute restano in FILE.partial (FILE.partial-2 e così via, se esiste già), e error.next esporta il resto dell’intervallo dall’ultimo received_at in un FILE-rest.csv non usato. Le righe ricevute in quell’istante esatto appaiono in entrambi, quindi scarta i duplicati durante l’unione. Con --output - il CSV incompleto resta su stdout, e l’errore e il comando next vanno su stderr.
xlsx e pdf vengono generati sul server e salvati allo stesso modo, tramite un file temporaneo privato. La busta riporta path, bytes, sha256, content_type e format, e il file contiene le prime 50.000 righe dell’intervallo.
playback list#
Leggi i totali di riproduzione giornalieri per questo progetto, giorni più recenti per primi.
playback list [--screen-id ID] [--media-id ID] [--day YYYY-MM-DD | --day-from YYYY-MM-DD --day-to YYYY-MM-DD]
[--format json|csv|xlsx|pdf] [--output FILE]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--screen-id ID | string | no | ogni schermo | Deve iniziare con scr_. |
--media-id ID | string | no | ogni oggetto | Deve iniziare con med_. |
--day YYYY-MM-DD | string | no | ogni giorno | Un giorno solare UTC. Non con --day-from o --day-to. |
--day-from YYYY-MM-DD | string | no | nessuno | Primo giorno di un intervallo di giorni UTC, estremi inclusi. Con --day-to l’intervallo è al massimo di 366 giorni. Un CSV lo predefinisce a 30 giorni prima di --day-to. Non con --day. |
--day-to YYYY-MM-DD | string | no | nessuno | Ultimo giorno di quell’intervallo. Un CSV lo predefinisce a oggi. Non con --day. |
--format FORMAT | string | no | json | json, csv, xlsx o pdf. csv trasmette in streaming ogni riga corrispondente, senza intervallo i 31 giorni fino a oggi. xlsx e pdf contengono le stesse righe dell’elenco JSON. |
--output FILE | path | no | ./playback-aggregates.csv, ./play-aggregates.xlsx o ./play-aggregates.pdf | Il file da scrivere; richiede un formato file. Con --format csv, - scrive il CSV su stdout invece della busta. |
screenrig playback list --screen-id scr_01EXAMPLESCREEN00000000 --day 2026-08-14
screenrig playback list --format csv --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback list --format pdf --day-from 2026-09-01 --day-to 2026-09-30 --output september.pdfUna riga per schermo, oggetto multimediale e giorno UTC. I filtri selezionano le righe proprie di chi chiama. JSON restituisce al massimo 200 righe in data.items, prima il giorno più recente; i totali giornalieri si aggiornano circa ogni 10 minuti e playback plays mostra gli avvii più recenti. La riga di intestazione del CSV è screen_id,media_id,filename,primitive,day,play_count,last_page_id,last_manifest_revision,first_started_at,last_started_at. Il CSV è una richiesta scritta come un CSV di riproduzioni, e la sua risposta riporta path, bytes, rows, sha256 e content_type; una risposta xlsx o pdf riporta path, bytes, sha256, content_type e format. Un’esportazione giornaliera fallita non conserva nulla; eseguila di nuovo.
playback totals#
Leggi i conteggi di riproduzione per giorno UTC o classifica gli schermi o i contenuti multimediali più attivi.
playback totals [--by day|screen|media|screen_day] [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD]
[--screen-id ID | --media-id ID] [--top N] [--format json|csv|xlsx|pdf] [--output FILE]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--by GROUPING | string | no | day | day risponde una riga per ogni giorno UTC. screen o media classificano i più occupati. screen_day risponde la serie giornaliera degli schermi principali. |
--day-from YYYY-MM-DD | string | no | 29 giorni prima di --day-to | Primo giorno UTC, incluso. |
--day-to YYYY-MM-DD | string | no | oggi | Ultimo giorno UTC, incluso. |
--screen-id ID | string | no | ogni schermo | Con --by day, conta solo questo schermo. Non con --media-id. |
--media-id ID | string | no | ogni oggetto | Con --by day, conta solo questo contenuto multimediale. Non con --screen-id. |
--top N | integer | no | 10 | Righe di un ranking, da 1 a 100; da 1 a 10 con --by screen_day. Richiede --by; non si applica a --by day. |
--format FORMAT | string | no | json | json, csv, xlsx o pdf. Gli altri tre scrivono le stesse righe in un file. |
--output FILE | path | no | ./play-totals.csv, ./play-totals.xlsx o ./play-totals.pdf | Il file da scrivere con --format csv, xlsx o pdf. Solo un percorso di file: - viene rifiutato. |
screenrig playback totals
screenrig playback totals --day-from 2026-09-01 --day-to 2026-09-30 --screen-id scr_01EXAMPLESCREEN00000000
screenrig playback totals --by screen --top 5
screenrig playback totals --by media --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback totals --by screen_day --top 3
screenrig playback totals --by screen --top 10 --format xlsx --output busiest-screens.xlsxI conteggi provengono dai riepiloghi giornalieri, che seguono l’ingestione con un ritardo fino a circa 21 minuti; playback plays mostra avvii più recenti. day risponde a data.days, screen e media rispondono a data.screens e data.media, e screen_day risponde a data.screen_days. Una serie giornaliera copre al massimo 366 giorni (92 con --screen-id o --media-id) e una classifica al massimo 92. data.truncated è true quando una classifica su una finestra troppo ampia per una lettura ha mantenuto solo le migliori chiavi di ogni fetta. Un formato file scrive il file del server in --output, e la sua busta riporta path, bytes, sha256, content_type e format.
playback completeness#
Leggi quante delle riproduzioni numerate dai Player sono arrivate a screenRIG per giorno UTC, e le lacune in cui mancano riproduzioni.
playback completeness [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD] [--screen-id ID] [--limit N]
[--format json|csv|xlsx|pdf] [--output FILE]| Parametro | Tipo | Obbligatorio | Predefinito | Note |
|---|---|---|---|---|
--day-from YYYY-MM-DD | string | no | 29 giorni prima di --day-to | Primo giorno UTC, incluso. L’intervallo copre al massimo 92 giorni. |
--day-to YYYY-MM-DD | string | no | oggi | Ultimo giorno UTC, incluso. |
--screen-id ID | string | no | ogni schermo | Solo questo schermo. Deve iniziare con scr_. |
--limit N | integer | no | 100 | Lacune da elencare, dalla più recente, da 1 a 500. |
--format FORMAT | string | no | json | json, csv, xlsx o pdf. Gli altri tre scrivono le stesse righe in un file. |
--output FILE | path | no | ./play-completeness.csv, ./play-completeness.xlsx o ./play-completeness.pdf | Il file da scrivere con --format csv, xlsx o pdf. Solo un percorso di file: - viene rifiutato. |
screenrig playback completeness
screenrig playback completeness --day-from 2026-09-01 --day-to 2026-09-30
screenrig playback completeness --screen-id scr_01EXAMPLESCREEN00000000 --limit 20
screenrig playback completeness --format pdf --output completeness.pdfOgni avvio di un media porta un numero, quindi una riproduzione che uno schermo ha eseguito e che non è mai stata consegnata, per esempio una eseguita offline oltre la sua coda di report di 24 ore, lascia una lacuna. data.completeness è data.measured_plays diviso data.measured_plays più data.missing_plays per la finestra, da 0 a 1, e null quando nessuno dei due è stato misurato: le riproduzioni senza numero, da Player che non numerano le proprie riproduzioni o prima che lo facessero, non vengono misurate. data.days fornisce gli stessi tre valori per ogni giorno UTC che ne ha, dal più vecchio, con una lacuna contata nel giorno della riproduzione che la segue. data.gaps elenca ogni lacuna, dalla più recente, con screen_id, day, from e to (gli orari di avvio delle riproduzioni ai due lati) e missing_plays; --limit ne limita il numero, e data.truncated è true quando ne esistono altre. Uno schermo spento non genera riproduzioni e non lascia lacune. Il riepilogo si aggiorna ogni 10 minuti. Una richiesta API misurata; il budget di esportazione riproduzione non si applica. Un formato file scrive il file del server in --output, e la sua busta riporta path, bytes, sha256, content_type e format.