Documentazione

Riferimento comandi CLI

Il CLI screenRIG pubblica contenuti multimediali, playlist e applicazioni su TV e kiosk da un terminale o da un agente. Trova comandi, parametri, output JSON e regole di revisione per pubblicare contenuti e gestire schermi.

Interfaccia CLI inclusa

I comandi sono raggruppati come li raggruppa la CLI. Installazione e primo utilizzo sono nella Guida rapida; la scelta tra caricamento, schede e selettori è in Compose.

GruppoComandiCosa copre
Progettiproject organization invitations agent login billing doctorCrea, seleziona, rinomina, sposta ed esporta progetti, accedi ed esci, invita persone, leggi limiti del piano e importi pubblicitari ed esegui doctor.
Clienti del servizioservice-clientCrea client del servizio, aggiungi e rimuovi chiavi e segreti e revocali: l’accesso per server, script e job CI.
Aiuto e assistenzahelp status docs recovery support feedbackCerca nella documentazione, controlla lo stato del servizio, recupera una scrittura dall’esito incerto, parla con l’assistenza e invia segnalazioni.
Mediamedia media folderCarica, sostituisci, versiona, tagga, sposta ed elimina immagini, video e audio, con cartelle, selettori dinamici e regole di disponibilità.
Sincronizzazione dei mediamedia sync media sync accountMantieni una cartella di media allineata a SharePoint, OneDrive, Dropbox o Google Drive: aggiungi account, crea sincronizzazioni ed eseguile.
PlaylistplaylistPrepara, convalida, crea, modifica, esporta e importa playlist, gestisci pagine, revisioni e istanze e sostituisci una release di applicazione.
Cardcard cards kv webhookTrova i tipi di card, crea una card, imposta parametri e dati live, vedine l’anteprima e aggiorna i dati da sistemi esterni con webhook firmati.
Applicazioniapp kv kv webhookImpacchetta, carica, aggiorna ed elimina applicazioni web e leggi o scrivi il loro archivio chiave/valore e i relativi webhook.
Schermiscreen browser setupAssocia, elenca, pubblica su, assegna, etichetta, sposta, ricarica, cattura ed elimina schermi e gestisci cartelle, link, video wall e vista live.
Programmazioniscreen schedule screen takeover schedule importImposta, vedi in anteprima, ripristina e cancella la programmazione di uno schermo, prendi il controllo degli schermi per un po’ e importa da un foglio.
CampagnecampaignCrea, visualizza, pubblica, promuovi, sospendi e ripristina campagne che portano un intero pubblico di schermi su una playlist secondo le regole.
Salute dei dispositiviscreen reboot screen display screen brightness screen uptimeRiavvia e aggiorna un dispositivo, programma display e riavvii, imposta la luminosità, blocca il chiosco e leggi uptime, salute e spazio di archiviazione.
Revisioni e notereviews comment notesElenca, mostra e ritira le revisioni delle modifiche degli agenti, allega commenti a schermi e playlist e lascia note del progetto per le sessioni future.
Notifichenotifications webhooks alerts events operationsAvvisa persone e sistemi quando uno schermo cambia stato con notifiche e webhook, segui il registro eventi, gestisci gli alert e attendi le operazioni.
Reportreports audit playbackCrea report e programmali via e-mail, leggi e verifica il registro di audit e interroga le prove di riproduzione: riproduzioni, totali e completezza.
Origini datifeeds source connectionLeggi feed di terze parti, mantieni aggiornata una card da un indirizzo esterno a orari prestabiliti e salva connessioni Microsoft e Google.
Dashboard BIbi connection bi viewCollega Grafana, Tableau, Power BI o una dashboard web, poi sfoglia, crea, testa e mostra le sue viste sugli schermi.
TriggertriggersPrendi il controllo degli schermi con gli alert di emergenza CAP e mostra sovrapposizioni da Home Assistant o client HTTP: crea, testa e ruota i trigger.
Collegamenti flottafleet-links migrateCrea collegamenti flotta per i gestori di dispositivi e sposta media, playlist, programmazioni e schermi di un’altra piattaforma di signage in screenRIG.
PubblicitàadsAcquista annunci in una rete che ti ha invitato o vendi pause pubblicitarie sui tuoi schermi: reti, inventario, slot, campagne e report.

Ogni comando viene eseguito allo stesso modo

screenrig [--json | --human] [--api-url URL] [--config PATH] [--request-id ID]
      [--project-id ID] [--idempotency-key KEY] [--timeout MS] <command> [args]

Flag globali

SegnalaTipoPredefinitoNote
--jsonbooleanJSON per operazioniOutput JSON esplicito, mantenuto per compatibilità. Seleziona anche aiuto strutturato. Non può essere combinato con --human.
--humanbooleanspentoSeleziona un output operativo leggibile. Non può essere combinato con --json.
--project-id IDstringultimo progetto usatoCorreggi questa invocazione a un progetto memorizzato nella cache senza cambiare la selezione. Ogni comando mantiene il suo obiettivo e stato di recupero per tutta la sua esecuzione.
--api-url URLstringhttps://api.screenrig.aiOrigine del piano di controllo. SCREENRIG_API_URL imposta la stessa cosa.
--config PATHpathil file di configurazione utenteUsa un file di configurazione specifico. SCREENRIG_CONFIG imposta la stessa cosa.
--request-id IDstringgenerato per esecuzioneIl tuo ID richiesta personale: req_ più da 16 a 64 lettere, cifre, _ o -. Va solo sulla prima richiesta e viene restituito come request_id. Conservalo nei report.
--idempotency-key KEYstringderivato per scritturaRiutilizza la stessa chiave per ritentare una scrittura ambigua. Il server restituisce il risultato originale per ventiquattro ore; un corpo diverso sotto la stessa chiave è idempotency_mismatch.
--timeout MSinteger30.000 per richiestaLimita ogni richiesta HTTP. Su un comando che attende un’operazione è invece il termine di attesa, e il valore predefinito è 120000.
--help, -hbooleanspentoStampa l’aiuto focalizzato per il comando o gruppo ed esci. Aggiungi --json per aiuto strutturato.
--version, -VbooleanspentoStampa la versione CLI inclusa ed esci. Uguale al comando version.

Ambiente

VariabileEffetto
SCREENRIG_API_URLOrigine del piano di controllo, che sovrascrive la configurazione memorizzata.
SCREENRIG_CONFIGPercorso al file di configurazione.
XDG_CONFIG_HOMEBase della directory di configurazione. Altrimenti %APPDATA%\screenrig su Windows, o ~/.config/screenrig.
SCREENRIG_FFMPEGPercorso assoluto a ffmpeg, quando media upload non deve prenderlo da PATH.
SCREENRIG_FFPROBEPercorso assoluto a ffprobe.
SCREENRIG_CWEBPPercorso assoluto a cwebp, il fallback ancora codificatore.

Nessuno di questi è una credenziale: non esiste alcun flag token né alcuna variabile ambiente per le credenziali. La CLI legge la sessione che il plugin ha salvato per questa installazione, in un file privato utente che sopravvive a un aggiornamento plugin, e la rinnova da sola. Una configurazione salvata con screenrig login --client-id accede invece come quel client di servizio, leggendo ogni volta il file della chiave o del segreto e mantenendo il token in memoria.

Output

I comandi operativi scrivono JSON su stdout per impostazione predefinita, inclusi gli errori. Un singolo risultato contiene una busta: ok, poi data, request_id, operation_id e warnings[] in caso di successo, o error in caso di fallimento. Avanzamento, URL sicuri e note umane vanno su stderr. events follow emette NDJSON: una busta JSON per evento, su una riga propria. Reindirizzare stdout non cambia il formato.

Usa --human per l’ispezione manuale. I comandi evento stampano una riga logfmt per evento. Aiuto e gruppi di comandi semplici restano testo leggibile per impostazione predefinita; usa screenrig --json playlist --help per la scoperta strutturata. --json e --human non possono essere combinati.

I bundle plugin più vecchi possono richiedere --json esplicito per i risultati operativi. Controlla l’aiuto della CLI installata quando lavori con un bundle più vecchio. I file di authoring playlist restano documenti JSON; un involucro risultato comando non è un documento playlist modificabile.

Una busta di errore contiene error.status, un error.code stabile e spesso error.next.command che indica esattamente cosa eseguire dopo. Ramifica su quelli invece che sul testo.

Una modifica che attende la revisione di una persona è un successo, non un errore: ok: true, esci 0, data.status: pending_review con il review, un avviso pending_review che indica l’URL della revisione, e data.next che punta a reviews show ID. Una rietichettatura di media approvati in revisione è ok, esci 0, con avviso media_review_pending invece: la sua revisione appare in reviews list entro pochi secondi. Vedi Revisioni.

Codici uscita

CodiceSignificato
0Successo.
1Errore imprevisto.
2Errore di utilizzo. Non è stato inviato nulla.
3Problema di credenziale. Questa installazione non può autenticarsi.
4Non trovato.
5Conflitto.
6Precondizione fallita, incluso revision_conflict: la revisione --expect-rev era obsoleta.
7Limite di frequenza. Rispetta Retry-After, mostrato come retry_after_seconds.
8Rifiuto lato client diverso.
9Errore del server.
10Errore di rete.
11Tempo scaduto.
12Errore di configurazione.
13L’operazione stessa è fallita.

Codici problema comuni nell’envelope:

CodiceSignificatoPasso successivo
not_enrolledQuesta installazione non ha ancora credenziali di progetto.Crea un progetto con screenrig agent enroll --email ADDRESS --organization "NAME". Usa screenrig login solo quando l’utente chiede di usare un account già esistente.
session_endedL’accesso è stato revocato, scaduto o terminato.screenrig login, approvato da una persona nel dashboard.
insufficient_accessIl livello di accesso della sessione non può fare questo: Read only non cambia nulla, e Propose non può eliminare, controllare schermi o spendere.screenrig agent status mostra effective_access. Quando access_limited_by nomina project o person, il proprietario del progetto modifica l’impostazione della revisione; altrimenti screenrig login --access manage, approvato da una persona.
approver_requiredSolo il proprietario del progetto o un membro che può approvare può farlo, come concedere a un agente Gestisci.Chiedi al proprietario del progetto di attivare Può approvare, o scegliere Solo lettura o Proporre.
playlist_not_approvedLa playlist non ha ancora una versione approvata, quindi nessuno schermo può mostrarla.Attendere la sua revisione (screenrig reviews show ID), oppure scegliere una playlist approvata.
review_not_pendingLa revisione è già stata decisa, ritirata o sostituita.screenrig reviews show ID per il suo stato.
login_denied, login_expiredLa persona ha negato l’accesso, o il suo codice 24 ore è scaduto.Esegui di nuovo screenrig login.
client_auth_failedLa chiave, il segreto o l’id di un client di servizio è stato rifiutato.Confronta il file di chiave o di segreto con cui accede la configurazione (login --client-id ID --client-key-file FILE o --client-secret-file FILE) con screenrig service-client show ID.
capability_requiredIl progetto non ha la capacità necessaria per questo comando, come screens o advertiser.screenrig project capabilities, poi scegli il --intent corrispondente per un nuovo progetto o cambia lo scopo del progetto.
rate_limitedTroppe richieste nella finestra corrente.Attendere retry_after_seconds, quindi riprovare.
free_organization_limitLa persona possiede già la sua organizzazione Standard gratuita, quindi project create non può avviarne un’altra.Aggiungi il progetto all’organizzazione indicata nei dettagli: screenrig project create NAME --organization-id ID. Un’altra organizzazione richiede Plus, Premium o Enterprise tramite il modulo di contatto su https://screenrig.ai/contact#message.
organization_plan_requiredL’organizzazione non ammette nuovi schermi finché un piano non lo paga.Il proprietario sposta il progetto con screenrig project moves e screenrig project move --organization-id ID, oppure l’organizzazione attiva Plus, Premium o Enterprise tramite il modulo di contatto su https://screenrig.ai/contact#message.

Revisioni e ritentativi

I guardiani di revisione sono opzionali. Ometti --expect-rev per scrivere la risorsa corrente senza una lettura di revisione precedente. Forniscilo con un revision noto per rifiutare scritture obsolete. Su revision_conflict, recupera nuovamente la risorsa, riapplica la modifica e ritenta con la revisione restituita. Su un errore di trasporto ambiguo, ritenta con lo stesso --idempotency-key; il piano di controllo restituisce il risultato originale invece di scrivere due volte.

Limite delle richieste agente

Gli agenti, le sessioni CLI e i client di servizio di un’organizzazione fanno fino a 500 richieste all’ora su Standard e Plus, 2.000 su Premium ed Education e 10.000 su Enterprise, in tutti i suoi progetti. Non viene addebitato nulla. Oltre il limite un comando fallisce con rate_limited e retry_after_seconds: attendi quel tempo, poi riprova una volta. Gli schermi continuano a riprodurre e la dashboard continua a funzionare.

Ogni chiamata API di un comando è una richiesta. Un comando di flotta, screen assign o screen tag con più ID schermo o --tag, è una richiesta indipendentemente da quanti schermi raggiunge, e screen screenshot --tag fa una richiesta per ogni pagina dell’elenco che segue. Ogni pagina JSON di playback plays o playback list è una richiesta, e un’esportazione di riproduzioni in CSV, XLSX o PDF è una richiesta per l’intero intervallo.

Non vengono contati: project show, agent status, billing, notes list, notes show, operations wait, events follow e la sua ripetizione, i messaggi di schermo screen reload, screen toast, screen identify, screen play-page, screen screenshot e screen live, le email di notifica, gli avvisi di schermo e le consegne di webhook, e i dati delle schede e le scritture chiave/valore, che mantengono un proprio limite.

Nomi comandi e scoperta

Usa show per ispezionare una risorsa, list per collezioni, e kv get / kv set per valori. Usa --name per nomi visualizzati, --screen-id, --app-id, --playlist-id e --release-id per selettori risorsa, --expect-rev per revision guard, e --after per cursori evento. Il gruppo è app; “application” è il nome risorsa. I commenti mantengono comment ACTION screen|playlist ID.

Usa screenrig help --all per l’inventario completo o screenrig playlist init --help per aiuto mirato. Aggiungi --json per metadati argomento, scelte, predefiniti, esempi e relazioni opzioni. I gruppi exactlyOne, atLeastOne, atMostOne e together sono controllati prima di configurazione o accesso rete; requires indica che la prima opzione richiede tutte le restanti. Leggi stdin solo dove l’aiuto comando supporta esplicitamente -.

Crea un nuovo progetto

screenrig agent enroll --email ADDRESS --organization "NAME"

agent enroll crea un’identità, un’organizzazione, un progetto e un’appartenenza, e memorizza credenziali di identità e progetto in modo privato. Assegna all’organizzazione il nome dell’azienda per cui sono gli schermi, altrimenti quello della persona, in base a quanto sai dalla conversazione. Passa Screens solo quando non conosci nessuno dei due, e screenRIG assegna all’organizzazione un nome in base all’indirizzo email. Il progetto riceve un nome leggibile di due parole che la persona può cambiare. --organization è obbligatorio; --name, al massimo 80 caratteri, nomina separatamente l’agente. Usa l’email di contatto reale della persona. L’iscrizione invia per email un invito a membro del progetto; non rivela se quell’indirizzo ha già un accesso. La persona apre l’invito e crea un accesso con passkey, o accede per aggiungere il progetto al proprio accesso esistente. L’accettazione sposta il progetto nell’organizzazione che detiene il dominio email verificato della persona, altrimenti nell’organizzazione Standard gratuita che già possiede, rinominata in caso di conflitto di nomi.

Aggiungi --intent advertising per un progetto che acquista annunci invece di associare schermi. --setup-code CODE collega il nuovo progetto alla visita al sito web che ha mostrato il codice, ad esempio K7QX-2MPD. --force sostituisce lo stato di iscrizione o connessione in sospeso di questa installazione quando si crea intenzionalmente un altro progetto.

agent enroll (--email ADDRESS | --agentid-claim CODE) --organization NAME [--name NAME]
    [--intent signage|advertising] [--setup-code CODE] [--force]

Accedi con AgentID

Un agente con un AgentID accede a https://api.screenrig.ai/agentid/start, riceve un codice di richiesta, installa il plugin ufficiale ed esegue screenrig agent enroll --agentid-claim CODE --organization "NAME". L’email verificata del proprietario riceve l’invito al dashboard.

Accedi a un account esistente

screenrig login

login registra questa installazione in un account già esistente. Stampa un indirizzo dashboard e un codice, poi attende fino a 24 ore. Una persona apre l’indirizzo, che contiene il codice, verifica che corrisponda, modifica il progetto, Read only, Proponi o Gestisci, o le aree di capacità se desidera, e preme Connetti una volta; un accesso dashboard dell’ultima ora è la prova, quindi non c’è un secondo prompt passkey. La CLI memorizza la sessione, seleziona il progetto approvato e restituisce status: signed_in con progetto, organizzazione e access.

login [--project ID] [--access read|propose|manage] [--name NAME] [--no-wait] [--resume ID]
login --client-id ID (--client-key-file PATH | --client-secret-file PATH)
logout

--access chiede un livello; il predefinito è manage, e la persona decide. --project suggerisce il progetto. --no-wait restituisce status: pending con il verification_uri_complete, il user_code e una maniglia login_ che non contiene segreti; login --resume ID attende l’approvazione successiva. Esegui di nuovo login su un’installazione con accesso per aggiungere un altro progetto o per elevare un progetto Read only o Propose a Manage.

Ogni sessione include aree di capacità: screens, content, playlists, advertising, reports e project. Una sessione richiama solo i comandi nelle sue aree; reports legge anche qualsiasi area. Un comando fuori da queste restituisce 403 forbidden con dettaglio This agent credential lacks the <name> capability.. Le sessioni di sola lettura elencano e leggono. Le sessioni di proposta caricano anche contenuti multimediali, scrivono note e propongono modifiche a contenuti, playlist e schermi, che attendono la revisione di una persona. Una modifica oltre il livello della sessione restituisce 403 insufficient_access.

logout revoca l’accesso sul server e rimuove i token memorizzati; nella configurazione di un client di servizio rimuove il client salvato. Un errore che potrebbe non aver raggiunto il server li mantiene, quindi rieseguire logout è sicuro. doctor mostra quando la sessione termina: 90 giorni dopo l’ultimo uso e al massimo un anno dopo l’accesso. Vedi Autenticazione.

Prepara, pubblica e modifica playlist

Per immagini e video pronti, prepara una playlist a schermo intero in ordine di riproduzione:

screenrig playlist init med_POSTER med_VIDEO --name "Lobby loop" --screen-id scr_LOBBY --output lobby.json
screenrig playlist validate lobby.json
screenrig screen publish scr_LOBBY lobby.json
screenrig screen screenshot scr_LOBBY

Convalida il documento, pubblicalo, poi guarda lo schermo reale con screen screenshot. playlist init accetta file immagine, video e audio locali, ID med_ pronti, release applicative rel_ fissate, URL iframe HTTP o HTTPS e codici di incorporamento <iframe> incollati in ordine di riproduzione, inclusi input misti:

screenrig playlist init ./poster.png med_VIDEO rel_APP https://example.com --name Lobby --screen-id scr_LOBBY --output lobby.json

Il caricamento di file locali avviene tramite il percorso media normale, fino a quattro alla volta, e attende la prontezza. Questo richiede ffmpeg e ffprobe a meno che non sia fornito --no-transcode. data.uploads elenca di ogni file source, media_id, reused e timing per fase. I file audio e gli ID med_ audio pronti diventano la colonna sonora, in ordine di input, invece di pagine. La preparazione scrive il documento locale e può caricare media; non crea né assegna playlist remote. I media esistenti devono essere pronti. Gli URL HTTP e HTTPS possono includere host della rete locale e credenziali incorporate e non vengono scaricati durante la preparazione. Un codice di incorporamento <iframe> incollato viene letto per il suo src e diventa una pagina iframe. L’app web del Player richiede URL HTTPS senza nome utente o password.

Se la preparazione viene interrotta, riesegui lo stesso comando. Nulla viene scritto finché ogni caricamento non è pronto, quindi nessun file di output blocca il nuovo tentativo, e un file il cui caricamento è già terminato restituisce il suo ID media esistente (reused: true) invece di caricarlo di nuovo.

Ogni input tranne l’audio diventa una pagina a schermo intero con sfondo nero e dissolvenza incrociata di 200 ms. Immagini e video usano --fit contain|cover|fill (predefinito contain). I video sono senza audio a meno che non sia indicato --sound, non si ripetono e avanzano al termine. Le altre pagine usano --duration-ms (predefinito 8000), e una pagina applicazione resta per 24 ore (86400000 ms) a meno che non sia indicata. Le applicazioni e gli iframe usano fill; le versioni delle applicazioni sono fissate con avanzamento temporizzato e senza privilegi di controllo. Modificare il documento per l’avanzamento controllato dall’applicazione. Verificare la prontezza della versione e la reale riproduzione tramite il server e il lettore previsto. La pubblicazione può esaminare le intestazioni di risposta delle pagine iframe HTTPS pubbliche idonee. Una pagina il cui X-Frame-Options o frame-ancestors rifiuta l’inquadramento non può essere mostrata dal Player web né dai Player macOS, Samsung Tizen, LG webOS o BrightSign. Quando la pubblicazione rileva un rifiuto, la scrittura riesce comunque: screen publish e le scritture di playlist come playlist create|update|patch stampano un avviso iframe_framing_refused che indica la pagina e la primitiva, e events list mostra un avviso playlist.iframe_framing_refused.

Fornisci --screen-id per leggere le dimensioni target e la revisione. Il risultato include data.screen_id, data.screen_revision e data.publish.argv. Passa questo array di argomenti al launcher screenrig incluso senza suddivisione shell: preserva percorsi, configurazione e origine API. Aggiungi esplicitamente --expect-rev per proteggere da modifiche successive allo schermo. I metadati target restano fuori dal documento creato. Uno schermo con un video wall fornisce la tela del suo wall e il format corrispondente.

Per sovrascrivere la tela, fornisci sia --target-width che --target-height. Questi funzionano anche senza uno schermo, nel qual caso non vengono restituiti argomenti di pubblicazione. Superfici sconosciute o multiple richiedono dimensioni esplicite. I file di output sono esclusivi per default; usa --overwrite per sostituire un file di authoring esistente in modo atomico. Un file vuoto non conta come esistente. Le directory genitore vengono create automaticamente. URL e input release-ID con dimensioni esplicite funzionano senza accesso.

screen publish <screen-id> <file> crea una nuova playlist, la assegna con una facoltativa guardia di revisione schermo, legge indietro l’assegnazione e attende che il Player la mostri. Non aggiorna una playlist esistente per nome. I nomi visualizzati possono ripetersi; usa l’ID playlist per un playlist update esplicito. Il suo risultato JSON riporta playlist_id, playlist_revision, screen_id, screen_revision, stage, assignment_verified, playback_verified e playback.

L’attesa è limitata da --timeout (predefinito 120000 ms) ed esegue il polling ogni --poll-ms (predefinito 2000 ms). Termina non appena il Player conferma la playlist sullo schermo: stage è playing e playback_verified è true. Altrimenti stage resta assigned e playback.reason, ripetuto come codice di avviso con il suo passo successivo, spiega perché:

playback.reasonSignificato
screen_offlineNessun Player è connesso; viene riprodotta quando il Player si riconnette.
playlist_not_effectiveUn takeover, una campagna o una programmazione mostra playback.effective_playlist_id; il predefinito pubblicato viene riprodotto quando termina.
playback_failedIl Player ha segnalato un aggiornamento non riuscito; playback.code ne indica la causa.
playback_pendingL’attesa è scaduta durante il download o la preparazione (playback.state).
not_waited--no-wait restituito dopo l’assegnazione senza attendere.

Un avviso playback_partial significa che la playlist viene riprodotta senza playback.missing_page_count pagine che non rientrano nell’archiviazione del Player.

Quando il progetto richiede la revisione per le modifiche dell’agente, o la sessione ha accesso Proponi, screen publish si ferma una volta proposta la playlist o la sua assegnazione: stage è pending_review, il risultato nomina entrambe le revisioni e la busta resta ok: true. Nulla viene riprodotto finché una persona non approva. Aggiungi --note TEXT per indicare al revisore cosa è cambiato; vedi Revisioni. Rieseguire la pubblicazione identica attende di nuovo e non crea mai un’altra playlist. --no-wait termina dopo l’assegnazione. Mentre è mostrata una pagina iframe, uno screenshot dell’app web Player è screenshot_unavailable (unsupported_surface); una pagina applicazione viene catturata così come l’applicazione la renderizza.

La pubblicazione salva automaticamente un diario locale privato. Dopo un errore ambiguo, ripeti lo stesso comando e input con la stessa configurazione per riprendere. Se la creazione della playlist è riuscita prima che l'assegnazione fallisse, l'errore identifica la playlist creata. Non eliminarla né avviare un'altra creazione per recuperare. Un conflitto di revisione richiede di ispezionare lo schermo e riconciliare l'assegnazione prevista; una playlist già creata può essere assegnata esplicitamente con screen assign. La pubblicazione non aggiorna mai silenziosamente la revisione prevista. Il recupero non completato si interrompe dopo la finestra di idempotenza del server di 24 ore; ispeziona e riconcilia prima di effettuare altre scritture.

Per modificare una playlist esistente:

screenrig playlist show pl_EXISTING --output lobby.json
screenrig playlist update pl_EXISTING lobby.json

playlist show --output scrive il documento modificabile, {name, pages} più audio, format e fields che la playlist ha, e restituisce il suo percorso, playlist_id e la fonte revision su stdout. Passa opzionalmente quella revisione con --expect-rev per proteggere l’aggiornamento. Preserva selettori dinamici, programmazioni, movimento e release di app fissate, rimuovendo i campi derivati dal server e di sola lettura, così il file viene convalidato e aggiorna la playlist così com’è. I commenti restano separati; i commenti di pagina passano in base all’ID pagina. Un playlist show semplice è una risposta di ispezione; --editable senza --output restituisce data.document, data.playlist_id e data.revision. L’aggiornamento di una playlist interessa ogni schermo assegnato. In revisione, playlist update propone il nuovo documento, e playlist show continua a restituire la versione live finché una persona non la approva. Per modificare una parte di una playlist, usa playlist rename, playlist patch o playlist page add|replace|remove, che inviano solo ciò che cambia.

Scritture K/V e commento accettano --file - per stdin. Usa playlist show ID --editable --human per il documento modificabile su stdout. I nomi visualizzati di app e playlist possono ripetersi; usa ID risorsa per aggiornamenti.

Sostituisci una release di app

Dopo un app update riuscito, prendi data.application.release_id e identifica la playlist, la pagina e il primitivo dell’applicazione esatti da modificare. Anteprima della sostituzione:

screenrig playlist replace-release pl_EXISTING --page board-page --primitive board --release-id rel_NEW

Questa è una revisione di impatto in sola lettura. Controlla data.previous_release_id, data.release_id e data.affected_screens, incluse le assegnazioni archiviate. Applica direttamente con --apply. Per aderire a questo controllo di impatto, fornisci anche --expect-impact con il data.impact dell’anteprima:

screenrig playlist replace-release pl_EXISTING --page board-page --primitive board --release-id rel_NEW --apply

Altri primitivi e impostazioni sono preservati. L’aggiornamento interessa ogni schermo assegnato a questa playlist condivisa; gli schermi archiviati mantengono il nuovo pin per usi successivi. Quando viene fornito --expect-impact, una sostituzione modificata, revisione o impatto osservato sullo schermo richiede una nuova anteprima. L’applicazione diretta salta il sondaggio dello schermo; affected_screens è omesso. Un rilascio già pinnato ha successo senza scrittura. Le assegnazioni possono cambiare dopo l’istantanea: il server verifica la revisione della playlist in modo atomico solo quando viene fornito --expect-rev. Il server convalida la disponibilità e la proprietà del rilascio all’applicazione. I pin esistenti restano invariati fino all’applicazione; successivamente, verificare le revisioni del manifesto e la riproduzione sugli schermi interessati. In revisione, --apply propone il nuovo pin; aggiungi --note TEXT per il revisore.

playlist validate, create, update e patch, e screen publish, accettano - come file di input per leggere da stdin, e playlist page add|replace accettano --file -. Le buste JSON non vengono mai scritte nei file creati. --expect-rev protegge una revisione. Omettere il flag per scrivere la risorsa corrente senza precondizione di revisione. Una revisione obsoleta fornita restituisce ancora revision_conflict.

Mantieni il percorso breve

Il CLI incluso usa api.screenrig.ai; i Player usano play.screenrig.ai; il dashboard è su screenrig.ai/dashboard; i rilascio usano origini isolate sotto apps.screenrig.ai. I pacchetti delle applicazioni raggiungono i Player nativi tramite una consegna privata, mediata dal server. Il riferimento trasporto interno resta disponibile per gli strumenti di trasporto.