Programmations : commandes CLI

Programmations et prise de contrôle

Les campagnes d’un écran et les entrées d’horaire de sa liste de lecture sont les niveaux d’une même pile. Le serveur décide de ce que chaque écran diffuse en partant du haut : sa prise de contrôle, les campagnes qui l’atteignent (--priority d’abord, puis la plus récente), les entrées d’horaire propres à l’écran dans l’ordre, la liste de lecture affectée avec screen assign, puis la liste de lecture par défaut du dossier d’écrans le plus proche qui en définit une. Le premier niveau en vigueur est diffusé. Les changements se font à environ une minute d’une limite, et les Players n’ont besoin d’aucune mise à jour. Une feuille de lignes d’horaire pour plusieurs écrans s’importe en une seule étape : voir Importation d’horaires.

Un niveau est en vigueur tant que toutes ses règles le sont : from et until, windows hebdomadaires, règles monthly, dates, dates except, une condition data et une condition interaction. Une règle monthly est un day du mois (de 1 à 31 ; un mois sans ce jour l’ignore) ou le jour de semaine de rang nth (de 1 à 4, ou -1 pour le dernier) avec un weekday ; un élément dates est une seule date ; les deux acceptent des heures start et end facultatives et couvrent sinon la journée entière. Une date except retire toute occurrence qui commence ce jour-là, y compris les prolongements de nuit, et une occurrence de nuit appartient à la date où elle commence. data est {key, path?, equals?} et est en vigueur tant que ces données de carte existent ou égalent la valeur scalaire. interaction est {idle_s} (de 5 à 3600, 60 par défaut) : le niveau joue tant que quelqu’un utilise l’écran par toucher, clic ou touche et revient en arrière après idle_s secondes sans saisie, comme une page interactive au-dessus d’une boucle d’attraction. displays liste les sorties du mur vidéo (de 1 à 12) sur lesquelles le niveau joue. covers est full (la page, par défaut), main, ou header, footer ou side, un bandeau tracé sur la page qui exige une liste de lecture conçue pour cette zone ; voir bandeaux. start est next_item (par défaut), qui attend la fin de l’élément en cours, ou on_time, qui l’interrompt à l’instant exact. Un Player qui résout sa propre pile joue les niveaux interaction, data, bandeau et displays ; campaign explain rapporte le niveau pour tout autre Player comme off avec la raison stack_only (nécessite un Player qui résout sa propre pile).

screen show, screen list, et les écritures d’horaire et de prise de contrôle ci-dessous retournent effective_playlist ({id, source, entry_id?, until?}, où source est takeover, campaign, schedule, default ou folder), takeover et playlist_schedule. entry_id est l’identifiant de campagne pour campaign, l’identifiant d’entrée pour schedule et l’identifiant de dossier pour folder. until est le prochain moment où le choix est connu pour changer. screen show --human l’imprime dans le fuseau horaire de l’écran, comme dans Assigned: pl_LUNCH (schedule entry lunch until 2026-08-14 15:00 America/Los_Angeles) ou Assigned: pl_LUNCH (campaign cmp_LUNCH until 2026-08-14 15:00 America/Los_Angeles) (UTC, étiqueté, quand l’écran n’a pas de zone) ; la sortie JSON conserve les instants RFC 3339. Les tableaux horaires humains sont étiquetés avec le fuseau horaire de l’écran, et screen list --human ajoute une colonne ASSIGNED quand un écran listé joue autre chose que sa liste de lecture par défaut.

Avec un identifiant d’écran, ces commandes retournent l’écran mis à jour et --expect-rev protège sa révision. Plusieurs identifiants, --tag TAG ou --folder ID (chaque écran actif de ce dossier d’écrans et de chaque dossier qu’il contient) s’exécutent comme une seule requête de flotte avec l’enveloppe et les règles de sortie de la flotte ; chaque écran échoue seul, et le CLI fait automatiquement pause et reprise lorsque le budget du projet est épuisé. Avec l’accès Propose, ou dans un projet qui exige une révision des changements des agents, une écriture sur un écran ou sur toute la sélection de la flotte répond pending_review : la commande réussit (sortie 0) avec data.review et un avertissement pending_review, data.next est screenrig reviews show ID, et rien ne change à l’écran avant qu’une personne l’approuve ; ne répétez donc pas l’écriture. --note explique la raison à la personne qui examine le changement ; voir Révisions. Sur un écran d’un dossier protégé, l’écriture attend un second approbateur à tous les niveaux d’accès.

screen schedule show <id>

screenrig screen schedule show scr_CAFE

screen schedule set (<id>... | --tag TAG | --folder ID) --file FILE [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule set scr_CAFE --file dayparts.json
screenrig screen schedule set --tag Cafe --file dayparts.json
screenrig screen schedule set --folder sfd_01EXAMPLEFOLDER000000000 --file dayparts.json

screen schedule clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule clear --tag Cafe

screen schedule preview <id> --file FILE [--calendar-from INSTANT] [--calendar-to INSTANT]

screenrig screen schedule preview scr_LOBBY --file dayparts.json
screenrig screen schedule preview scr_LOBBY --file dayparts.json --calendar-from 2026-12-01T00:00:00Z --calendar-to 2027-01-01T00:00:00Z

screen schedule revisions <id> [--after CURSOR]

screenrig screen schedule revisions scr_LOBBY
screenrig screen schedule revisions scr_LOBBY --after CURSOR

screen schedule restore <id> --revision N [--expect-rev REVISION] [--note TEXT]

screenrig screen schedule restore scr_LOBBY --revision 4
screenrig screen schedule restore scr_LOBBY --revision 4 --expect-rev 9

screen takeover [set] (<id>... | --tag TAG | --folder ID) --playlist-id ID [--until TIME | --for DURATION] [--reason TEXT] [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover scr_LOBBY --playlist-id pl_DRILL --for 30m --reason "Fire drill"
screenrig screen takeover --tag Lobby --playlist-id pl_LAUNCH --for 2h
screenrig screen takeover --folder sfd_01EXAMPLEFOLDER000000000 --playlist-id pl_LAUNCH --for 2h
screenrig screen takeover scr_A scr_B --playlist-id pl_NOTICE --until none

screen takeover clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION] [--note TEXT]

screenrig screen takeover clear --tag Lobby

Le fichier d’horaire

Un horaire liste de 1 à 32 entrées par ordre de priorité ; la première entrée en vigueur l’emporte. Une entrée nomme un playlist_id et définit au moins une règle d’un niveau : windows, monthly, dates, except, data, interaction, from ou until, et facultativement displays, covers, start et paused. windows compte de 1 à 16 éléments dans le fuseau horaire de l’écran : days utilise mon à sun, et start et end sont HH:MM ; omettre les deux pour toute la journée. Un end à ou avant start traverse minuit et appartient au jour de début. monthly compte de 1 à 16 éléments, et dates et except de 1 à 100 chacun, avec une date except une seule fois. Le serveur refuse une date except en dehors de from et until, un élément dates qui commence en dehors de ces bornes, et un élément dates qui est aussi une date except. from (inclusif) et until (exclusif) sont facultatifs et sont des minutes civiles telles que 2026-12-24T18:00, sans décalage ; from précède until. covers est full (par défaut), main, header, footer ou side, displays liste de 1 à 12 sorties différentes, et start est next_item (par défaut) ou on_time, comme dans les règles de niveau ci-dessus. Un id compte de 1 à 64 lettres, chiffres, - ou _, et n’est utilisé qu’une fois ; un id omis devient entry_N. Une entrée avec "paused": true est un brouillon : elle n’est dans la pile d’aucun écran, screen schedule show la marque et le calendrier la dessine en pointillés. Renvoyez l’horaire sans paused pour la publier. Le CLI vérifie cette forme avant d’envoyer quoi que ce soit. Tranches horaires petit-déjeuner, déjeuner et dîner :

{
  "entries": [
    { "id": "breakfast", "playlist_id": "pl_BREAKFAST",
      "windows": [{ "days": ["mon", "tue", "wed", "thu", "fri"], "start": "06:00", "end": "11:00" },
                  { "days": ["sat", "sun"], "start": "08:00", "end": "12:00" }] },
    { "id": "lunch", "playlist_id": "pl_LUNCH",
      "windows": [{ "days": ["mon", "tue", "wed", "thu", "fri"], "start": "11:00", "end": "15:00" }] },
    { "id": "dinner", "playlist_id": "pl_DINNER",
      "windows": [{ "days": ["mon", "tue", "wed", "thu", "fri", "sat", "sun"], "start": "17:00", "end": "22:00" }] }
  ]
}

Un menu qui joue tant que quelqu’un utilise l’écran, au-dessus d’un brunch du premier dimanche qui saute une date :

{
  "entries": [
    { "id": "browse", "playlist_id": "pl_MENU", "interaction": { "idle_s": 90 } },
    { "id": "brunch", "playlist_id": "pl_BRUNCH",
      "monthly": [{ "nth": 1, "weekday": "sun", "start": "10:00", "end": "14:00" }],
      "except": ["2026-12-06"] }
  ]
}

Une programmation de liste de lecture choisit entre des listes de lecture ; la page visibility à l’intérieur d’une liste choisit encore entre ses pages.

Événements de programmation et de prise de contrôle

events list et events follow impriment screen.playlist_switched (playlist_id, previous_playlist_id, source, entry_id, until), screen.takeover_started (playlist_id, until, où none signifie retenu jusqu’à effacement, et reason), screen.takeover_updated (playlist_id, until, previous_until et reason, où none signifie retenu jusqu’à effacement : la même prise de contrôle dotée d’une nouvelle fin), screen.takeover_ended (playlist_id, until s’il y en avait une, et reason expired, cleared, replaced, playlist_deleted ou playlist_unavailable), et l’avertissement screen.playlist_unavailable (playlist_id, code playlist_deleted ou playlist_unavailable, et les entry_ids, campaign_ids ou folder_id qui nomment la liste de lecture).

La suppression d’une liste de lecture échoue avec resource_conflict (sortie 5) tant qu’un écran, archivé ou non, l’a affectée, nommée par une entrée d’horaire, détenue par une prise de contrôle ou effective, ou tant qu’une campagne ou la liste par défaut d’un dossier d’écrans la nomme. next pointe vers screen list.

Importation d’horaires

schedule import lit une feuille de lignes d’horaire (écran, fichier, début, fin), vérifie chaque ligne par rapport au projet, présente un aperçu des niveaux qu’elle crée et de l’effet sur le calendrier, et avec --commit applique tout ou rien. schedule template enregistre une feuille pour démarrer. L’importation d’horaires décrit les colonnes, les cibles, les heures et les erreurs de ligne. L’horaire propre à un seul écran se définit avec screen schedule set, et une campagne programme une audience.

L’aperçu et la validation relèvent de Premium et des forfaits supérieurs : un forfait sans importation d’horaires répond feature_not_in_plan (sortie 8), et le modèle est ouvert à tous les forfaits. L’aperçu et la validation ne sont pas disponibles pour un appelant limité à des dossiers d’écrans (outside_screen_scope, sortie 3).

schedule import <file> [--name NAME] [--timezone ZONE] [--code-field FIELD] [--commit]

screenrig schedule import schedule.csv
screenrig schedule import schedule.xlsx --name "Spring promos" --timezone America/Los_Angeles
screenrig schedule import schedule.csv --name "Spring promos" --commit
screenrig schedule import rows.json --code-field room_id
screenrig schedule import - --name "Spring promos" --commit

schedule template [--format csv|xlsx] [--output FILE] [--overwrite]

screenrig schedule template
screenrig schedule template --output schedule.csv
screenrig schedule template --format xlsx --output schedule.xlsx --overwrite