Cómo desplegar cartelería digital headless que su agente opera

En una configuración headless, el plano de control es una API, no una página web. Su agente, un script o un trabajo de CI hace las mismas llamadas que haría una persona en el panel, a través de la CLI, la API REST o el servidor MCP remoto. El Player de cada pantalla descarga lo que se le indica reproducir, lo reproduce desde el almacenamiento local e informa: qué está mostrando, su estado y qué controles admite el dispositivo. El panel sigue ahí para quien lo quiera; nada depende de que esté abierto. Cartelería digital headless explica el modelo, y la página de la API cubre todas las interfaces.

Para un agente de IA, péguele una frase y instalará el plugin oficial de screenRIG, que incluye la skill y la CLI screenrig. En su primera ejecución se registra: crea su organización y su proyecto y le envía una invitación por correo. Inicio rápido incluye la frase y los comandos de instalación para cada agente.

Un cliente MCP como Claude, ChatGPT o Grok puede conectarse en su lugar al servidor MCP remoto: una persona lo aprueba en el panel y elige para él Solo lectura, Proponer o Administrar. Solo lectura basta para un agente que solo observa, como en la sesión anterior. El plugin añade los pasos que se ejecutan en su equipo, como convertir medios y empaquetar apps. Conectar un cliente MCP incluye la dirección del servidor y el inicio de sesión.

Para un script, un trabajo de CI o su propio servicio, cree un cliente de servicio solo con el acceso que necesite:

screenrig service-client create --name "rollout-pipeline" --access manage

Un cliente de Solo lectura sirve para una tarea de supervisión, y los cambios de un cliente con Proponer esperan a que una persona los revise. Clientes de servicio explica el inicio de sesión con una clave o un secreto.

Elija dispositivos que arranquen solos y que pueda recuperar a distancia. Una Raspberry Pi o un PC Linux con instalación de kiosco, un reproductor BrightSign, un PC con Windows o un dispositivo Android administrado pueden reiniciarse a petición; los sticks y las apps de TV son más baratos, pero no pueden. Cómo elegir un reproductor de cartelería digital los compara, y Descargas enumera todos los dispositivos.

Un código de vinculación basta para una pantalla. Para diez, un enlace de flota es una única URL del Player que convierte cada dispositivo que la abre en su propia pantalla dentro de su proyecto, con las etiquetas, los campos y la lista de reproducción del enlace, y sin ningún código que dictar.

screenrig fleet-links create --name "Kitsilano counters" --tag Kitsilano --tag Counter --playlist-id pl_MENU --max-screens 6 --expires-at 2026-11-30T23:59:59Z

La respuesta incluye la URL. Es una credencial que crea pantallas, así que entréguela solo a la configuración del dispositivo, nunca a una página ni a un chat. Después colóquela donde el dispositivo la encuentre:

• Raspberry Pi y Linux. Ejecute el instalador como kiosco con el enlace: curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk --fleet-link URL. Después el dispositivo arranca directamente en el Player, se une al proyecto y se recupera solo tras un corte de energía.
• Android, Google TV y Amazon Signage Stick. Defina la clave fleet_link en la configuración administrada de la app en su administrador de dispositivos (paquete ai.screenrig.player).
• Un dispositivo Android 10 o posterior restablecido de fábrica y con cámara. Escanee el código QR de propietario del dispositivo Android del enlace desde la pantalla de bienvenida. El Player administrado se instala solo como la app de inicio del dispositivo, a pantalla completa, sin administrador de dispositivos.
• Mac, Apple TV, iPhone y iPad. Defina fleet_link en la configuración de app administrada de su MDM.
• ChromeOS. Ponga el enlace en la URL de la app de kiosco en la consola de administración de Google.

--max-screens y --expires-at impiden que un enlace filtrado cree pantallas indefinidamente; las pantallas que ya creó siguen reproduciendo. Un dispositivo restablecido con Powerwash o reinstalado vuelve como la misma pantalla cuando su identidad anterior lleva diez minutos en silencio. La guía del Player incluye el ajuste de cada administrador de dispositivos.

Los horarios se ejecutan en la zona horaria de cada pantalla, así que defínala y luego indique a las pantallas cuándo deben estar encendidas:

screenrig screen set-timezone scr_KITS_COUNTER_1 --timezone America/Vancouver
screenrig screen display-schedule set --tag Window --file store-hours.json

El horario de pantalla se ejecuta en el reproductor, así que un escaparate se apaga al cierre aunque no haya internet en la tienda. Los Players que lo admiten apagan la propia TV por HDMI-CEC, DDC/CI o la retroiluminación; los demás ponen la imagen en negro. Vea HDMI-CEC para cartelería digital. En todos los planes, un horario de reinicio reinicia los dispositivos en una franja tranquila, como "Mon-Sun 04:00-04:30".

Un agente publica a partir de una frase. Desde código, screen publish crea una lista de reproducción a partir de un archivo preparado, la asigna y espera hasta que el Player informa de que la está mostrando:

screenrig screen publish scr_KITS_COUNTER_1 menu.json
screenrig screen screenshot --tag Kitsilano --output shots/

Una asignación no es prueba de reproducción, así que la publicación espera al Player, y una captura muestra lo que hay en pantalla. Los cambios de flota van por etiqueta o carpeta, y una acción de flota es una solicitud sin importar cuántas pantallas alcance. Una escritura puede llevar una comprobación de revisión (--expect-rev), para que dos autores no se sobrescriban en silencio.

Cada proyecto incluye de entrada un correo electrónico a su propietario cuando una pantalla lleva 10 minutos sin conexión. Añada las condiciones que le interesen:

screenrig notifications create --email owner --conditions screen_offline,display_disconnected,not_playing,glass_blank,glass_frozen --tag Kitsilano

Las notificaciones también vigilan un dispositivo que se calienta demasiado, el almacenamiento lleno, una actualización de contenido atascada, un Player que se cierra una y otra vez y una lista de reproducción que ha dejado de avanzar. El correo electrónico y los webhooks firmados vienen con todos los planes; el envío a Slack, Teams, PagerDuty o Telegram viene con Plus. Para un agente que reacciona por sí solo, screenrig events follow transmite los eventos del proyecto, y los eventos de pantalla son gratuitos en el flujo de escucha.

Cada Player informa de su estado cada quince minutos y de inmediato cuando cambia la conexión con su pantalla o su alimentación eléctrica: tiempo de actividad, memoria, temperatura en los dispositivos que la tienen, red y fallos. screen show lo devuelve junto con las capacidades de host de la pantalla, de modo que el agente sabe qué puede hacer una pantalla antes de intentarlo.

Cuando una pantalla falla, el agente empieza por la solución más económica y va escalando, y solo usa lo que declara ese Player:

1. Revisar. screen show informa de la última interrupción de la pantalla y, cuando un informe de estado lo determina, de una causa probable: un reinicio del dispositivo, una caída de la app, la red o screenRIG. Una captura de pantalla muestra lo que hay en la pantalla.
2. Recargar. screen reload actualiza el contenido sin tocar el dispositivo.
3. Reiniciar la app o borrar la caché. screen restart-app reinicia el Player; screen clear-cache elimina el contenido descargado, conserva la vinculación y lo descarga de nuevo.
4. Reiniciar. screen reboot reinicia el dispositivo en los Players que lo admiten. Enviado a una pantalla sin conexión, espera en cola hasta 24 horas y se ejecuta cuando la pantalla vuelve. Un reinicio que usted ha pedido no genera ninguna alerta de desconexión mientras el dispositivo se reinicia.
5. Cambie el hardware. Si un dispositivo deja de funcionar, vincule el de repuesto y ejecute screen replace: el nuevo dispositivo asume el nombre, las etiquetas, la zona horaria, la lista de reproducción, las programaciones y el historial de la pantalla anterior.

La referencia de la CLI enumera todos los comandos de dispositivo y los Players que los admiten.

• Agente conectado, o un cliente de servicio con el menor acceso que necesita
• Reproductores elegidos por su reinicio remoto donde una visita al sitio es costosa
• Un enlace de flota por tienda o grupo, con etiquetas, una lista de reproducción, un límite de pantallas y una caducidad
• Zona horaria definida para cada pantalla
• Horario de pantalla para las pantallas que deben estar apagadas fuera de horario
• Primera publicación verificada con una captura de pantalla de cada pantalla
• Notificaciones por desconexión, pantalla desconectada, sin reproducción e imagen en blanco o congelada
• Una persona designada que recibe las alertas

¿Necesito el panel en absoluto?

No. Todo lo de esta guía funciona desde el agente, la CLI o la API. El panel es un cliente más, útil cuando una persona quiere echar un vistazo.

¿Puedo desplegar sin dictar códigos de vinculación?

Sí. Un enlace de flota registra cada dispositivo que lo abre, ya sea desde un administrador de dispositivos, un parámetro del instalador de Linux o un código QR de Android.

¿Qué pasa cuando se cae internet en una tienda?

Los Players nativos siguen reproduciendo lo que descargaron, y los horarios de pantalla siguen ejecutándose en el dispositivo. Usted recibe un aviso de desconexión cuando la pantalla lleva sin conexión el tiempo de espera que haya fijado.

¿Cuánto cuesta un despliegue?

screenRIG es gratis, con pantallas ilimitadas en Standard. Vea precios para saber qué añaden los planes de pago.

• screenrig.ai/docs/start
• screenrig.ai/docs/players
• screenrig.ai/docs/cli
• screenrig.ai/docs/service-clients