Enlaces de flota: comandos CLI

Crear un enlace de flota y recibir su URL de Player.

fleet-links create --name NAME [--tag TAG]... [--field NAME=VALUE]... [--playlist-id ID] [--max-screens N]
                   [--expires-at TIME] [--disabled]

screenrig fleet-links create --name "Lobby displays" --tag Lobby --tag Floor2 --playlist-id pl_01EXAMPLEPLAYLIST000000

screenrig fleet-links create --name "Trade show" --field booth=A12 --expires-at 2026-12-31T23:59:59Z

El sobre es el enlace de la flota con su URL de Player en data.url. Ponga esa URL en el administrador de dispositivos. Después de una creación interrumpida o ambigua, vuelva a ejecutar el mismo comando dentro de 24 horas: reutiliza la clave de idempotencia guardada, y el servidor devuelve el mismo enlace en lugar de crear otro.

Listar los enlaces de flota de este proyecto, los más antiguos primero.

fleet-links list

screenrig fleet-links list

Una credencial de solo lectura recibe cada data.items[].url vacío con url_redacted: true. --human imprime ID, LABEL, ENABLED, SCREENS, TAGS y LAST_USED, añade EXPIRES mientras un enlace listado tiene caducidad y marca con (expired) el que la ha superado, y nunca imprime la URL. SCREENS es el número de pantallas que creó el enlace, o creado/máximo con --max-screens; las recuperaciones no se cuentan.

Inspeccionar un enlace de flota y recibir su URL de Player.

fleet-links show <id> [--android-provisioning]

screenrig fleet-links show flk_01EXAMPLELINK0000

screenrig fleet-links show flk_01EXAMPLELINK0000 --android-provisioning

screens_created cuenta las pantallas que creó el enlace, y last_used_at es la última vez que creó o recuperó una. expires_at está presente cuando el enlace tiene caducidad, y la salida legible la marca con (expired) una vez pasada.

Con --android-provisioning, data.id y data.provisioning sustituyen los detalles del enlace. El JSON contiene el secreto del enlace: muestre su código QR solo a la persona que está junto al dispositivo. Una credencial de solo lectura no recibe ninguna URL con la que construirlo y obtiene fleet_link_secret_unavailable (salida 3). Propietario del dispositivo Android con un código QR lista la carga.

Cambiar lo que un enlace de flota da a las pantallas que crea a partir de ahora.

fleet-links update <id> [--name NAME] [--enable | --disable] [--tag TAG]... [--clear-tags]
                        [--field NAME=VALUE]... [--clear-fields]
                        [--playlist-id ID | --clear-playlist] [--max-screens N | --clear-max-screens]
                        [--expires-at TIME | --clear-expires-at] [--expect-rev REVISION]

screenrig fleet-links update flk_01EXAMPLELINK0000 --playlist-id pl_01EXAMPLEPLAYLIST000000

update cambia solo los campos que pase, y solo para pantallas que el enlace cree a partir de ahora. Las pantallas ya creadas mantienen sus etiquetas, lista de reproducción y etiqueta. Un enlace caducado se comporta como uno desactivado hasta que su caducidad se mueva o se elimine. La URL no cambia; use rotate para reemplazarla.

Reemplazar la URL de un enlace de flota y recibir la nueva.

fleet-links rotate <id> [--expect-rev REVISION]

screenrig fleet-links rotate flk_01EXAMPLELINK0000

El sobre lleva la nueva URL en data.url. La URL antigua deja de funcionar de inmediato: un dispositivo que la abre muestra su código de vinculación. Las pantallas que ya crearon el enlace siguen reproduciéndose, porque un Player vinculado nunca presenta el enlace de nuevo. Ponga la nueva URL en el administrador de dispositivos. Tras una rotación interrumpida o ambigua, vuelva a ejecutar el mismo comando: reutiliza la clave de idempotencia guardada, y el servidor devuelve la rotación que ya ocurrió en lugar de rotar de nuevo.

Eliminar un enlace de flota. Su URL deja de funcionar de inmediato y las pantallas que creó permanecen.

fleet-links delete <id> [--expect-rev REVISION]

screenrig fleet-links delete flk_01EXAMPLELINK0000

Las pantallas cuyo enlace se creó mantienen sus listas de reproducción y etiquetas.

Lista las plataformas que lee migrate, lo que admite cada una y cómo crear su clave de solo lectura.

migrate vendors [VENDOR]

screenrig migrate vendors
screenrig migrate vendors files

Funciona sin conexión y no requiere inicio de sesión. data.vendors contiene, para cada plataforma, su id y name; inputs, con las flags que admite (cada una con flag y required, y values para una región) y las líneas credentials que contiene su archivo de clave (name, secret, required y help); connect, los pasos para crear una clave de solo lectura; maps, lo que se migra; skips, lo que no; docs; y example, un comando migrate scan que funciona. Las plataformas se ordenan por id con files al final. files acepta una carpeta o .zip y una zona horaria opcional, y no necesita clave.

Lee una cuenta de señalización e informa de lo que se puede y no se puede migrar. Escribe scan.json y no envía nada a screenRIG.

migrate scan --from VENDOR [--url ADDRESS] [--region REGION] [--timezone ZONE] [--files PATH]
    [--credentials FILE] [--dir DIR]

screenrig migrate scan --from files --files ./signage-media
screenrig migrate scan --from files --files ./signage-media.zip --dir ./old-signage --timezone America/Toronto

Una opción que la plataforma no admite, o una que necesita y falta, es usage_error (salida 2) y nombra lo que la plataforma admite. Ninguna opción recibe la clave en sí. Un escaneo nuevo reemplaza scan.json y conserva map.json, y sale con 0 cuando termina, aunque algunos elementos no puedan migrarse.

data es el informe: vendor, label, scanned_at, found y importable (conteos de media, playlists, layouts, schedules, groups y screens), not_imported (cada uno con kind, source_id, name, un reason y normalmente un paso next), lossy (cada uno con kind, source_id, name y el change que ocurre por el camino), notes, dir y scan_file. Un archivo que la plataforma entrega se descarga en apply. Un archivo que no entrega, o que entrega solo como copia recodificada, se empareja por nombre en --files; si no hay coincidencia, o hay varias, aparece en not_imported o lossy con el paso que lo corrige.

--from files no necesita clave. Lee cada archivo de imagen, video y audio por su contenido, no por su extensión. Un playlists.csv opcional en la raíz tiene las columnas playlist, file (una ruta o un nombre de archivo único), duration (segundos) y order; sin él, cada carpeta que contiene medios se convierte en una lista de reproducción en orden natural de nombre de archivo, y los archivos de la raíz forman una que lleva el nombre de la carpeta o del zip. Un screens.csv opcional tiene name, group (varios separados por ;), playlist y timezone, y cada fila se convierte en una pantalla en espera con sus grupos como etiquetas. Los demás archivos y las entradas de zip cifradas están en not_imported. Un escaneo de files no tiene programaciones: créelas con campaign create cuando existan las listas de reproducción.

Importa lo que encontró el escaneo: medios, listas de reproducción y diseños, pantallas en espera y campañas. Se puede volver a ejecutar sin riesgo.

migrate apply [--dir DIR] [--dry-run] [--only KINDS] [--folder ID] [--canvas WIDTHxHEIGHT]
    [--credentials FILE] [--concurrency N] [--no-transcode]

screenrig migrate apply --dry-run
screenrig migrate apply --dir ./screenrig-migration-files
screenrig migrate apply --only media,playlists --concurrency 2

apply importa en orden: los medios en una carpeta, las listas de reproducción y los diseños, una pantalla en espera por cada pantalla anterior y una campaña por cada programación que las campañas pueden expresar. Solo vuelve a leer la plataforma para descargar archivos multimedia. Una lista de reproducción tiene una página por elemento: las imágenes y los videos llenan el lienzo, una dirección web se convierte en una página iframe, el audio se convierte en la banda sonora y una lista de reproducción anidada se incorpora en línea. Un diseño se convierte en una lista de reproducción en su propio lienzo, con una página por cada elemento de su zona principal. Una programación que se repite por mes, año, hora o minuto, o en un día de la semana numerado del mes, no puede convertirse en campaña: scan la lista en not_imported.

--dry-run lee solo el proyecto y responde data.plan (para media, playlists, layouts, screens y schedules: conteos create, reuse, recreate, waiting y fail), data.items, data.bytes por descargar, conteos data.placeholders y data.project, los enlaces de flota y las campañas en uso frente a sus máximos de 50 y 100. El progreso va a stderr como líneas JSON (migrate_progress con phase, done y total), o como texto con --human. Una nueva ejecución reutiliza lo que aún existe, vuelve a crear lo que haya eliminado y nunca cambia lo que creó. Una ejecución real responde data.applied (los mismos conteos), data.waiting (elementos que esperan a un medio o a una lista de reproducción que no está importada, cada uno con un reason), data.failed, data.placeholders (una entrada por pantalla anterior con su source_id, name y state: linked, unlinked, paired, finished o waiting), data.tags y data.folder_id.

Un grupo se convierte en una etiqueta formada por letras y dígitos, numerada cuando coincide con una etiqueta que lleva otra pantalla. Una campaña apunta a las etiquetas de los grupos y las pantallas que nombra su programación, con sus fechas, días, horas y prioridad. Una campaña lee sus fechas y horas en la zona horaria propia de cada pantalla y necesita una lista de reproducción predeterminada (no_default_playlist): scan indica las pantallas que carecen de ella, y screen assign la establece tras la vinculación.

Una pantalla en espera es un enlace de flota de una sola pantalla que lleva el nombre anterior, los grupos como etiquetas y la lista de reproducción. Una organización tiene como máximo 50 enlaces de flota entre todos sus proyectos; el resto aparece como unlinked en data.placeholders y espera un código de Player (migrate pair). Un Player que abre un enlace se convierte en una pantalla, y volver a ejecutar apply le da el nombre anterior y la zona horaria y elimina el enlace. apply nunca imprime la URL de un enlace de flota: fleet-links show sí.

Un elemento que falla conserva ok true con data.failed (cada uno con key, name, code, status y detail) y la advertencia migration_items_failed; los elementos que dependen de él esperan, y el código de salida sigue el estado del último fallo. Un archivo multimedia que falla por sí solo (una dirección caducada, una respuesta que no es un archivo, una descarga que deja de responder) hace fallar únicamente ese medio; para una dirección caducada, ejecute migrate scan de nuevo. Un rechazo que se repetiría en todos los elementos (quota_exceeded, campaign_limit_reached, insufficient_access, pending_review, la plataforma que rechaza la clave, una conexión perdida) termina la ejecución con data.stopped (code, detail y next) y el código de salida de ese problema. Corrija la causa y ejecute el mismo comando de nuevo: continúa donde se detuvo.

Vincula un código de Player a una pantalla en espera, con su nombre anterior, lista de reproducción, zona horaria y etiquetas.

migrate pair <CODE...> --screen ID_OR_NAME [--dir DIR]

screenrig migrate pair ABC 234 --screen "Front desk"
screenrig migrate pair ABC234 --screen 3 --dir ./old-signage

Ejecute primero migrate apply: la vinculación necesita el mapa y la lista de reproducción que creó. pair reclama el código para la pantalla con su nombre anterior, establece su lista de reproducción, zona horaria y campo migrated_from, establece sus etiquetas, elimina el enlace de la pantalla en espera y registra el resultado. data contiene source_id, name, screen_id, steps (paired, updated, tagged, link deleted, recorded), next y, cuando esta ejecución reclamó el código, public_url. Cada paso se registra al completarse, así que una nueva ejecución termina lo que dejó una vinculación interrumpida. Una pantalla que ya está vinculada es resource_conflict (salida 5), que la nombra. El Player termina de vincularse la próxima vez que contacta con el servicio; screen show informa entonces state active.