Poner el reproductor en su pantalla

¿Qué Players están disponibles?

Reproductores: la aplicación web Player (PWA), Android en Google Play, Amazon Signage Stick, Apple TV, macOS, iPhone y iPad, Windows, paquetes para Linux y Raspberry Pi, LG webOS Signage, BrightSign y Samsung Smart Signage (Tizen). Instale un reproductor nativo para la reproducción más rápida y confiable.

La app web del reproductor (PWA) en play.screenrig.ai/player/ funciona en cualquier pantalla con navegador moderno: un smart TV o monitor comercial con navegador integrado, un dispositivo ChromeOS gestionado en modo kiosco, una tableta o una computadora conectada a la pantalla. Un embed solo de estado del reproductor está en play.screenrig.ai/player/embed/status/.

Cada Player muestra un código de vinculación. Entréguelo a su agente, y él se encarga del resto.

Cada Player, excepto Windows, también muestra un código QR en su pantalla de vinculación. Escanéelo con un teléfono que haya iniciado sesión en el panel y confirme con Vincular pantalla.

Sincronización eventual

Los Players de Android, Amazon Signage Stick, macOS, Windows, Linux y Raspberry Pi alinean gradualmente los cambios de página con Players cercanos que muestran la misma revisión de playlist. Asigne la misma playlist a pantallas en una subred IPv4. Use duraciones fijas de página de al menos un segundo, elimine transiciones y no use animaciones de entrada. Cada Player transmite un pequeño beacon de inicio de página y ajusta ligeramente su espera antes de la siguiente página. Los ajustes de tiempo se activan solo después de descubrir un segundo Player en esa misma revisión de playlist. Las pantallas en diferentes playlists no se influyen entre sí. Una pantalla solitaria mantiene su temporización normal; el grupo sigue la posición media de reproducción una vez que se unen pares.

La red debe permitir la transmisión UDP de dispositivo a dispositivo en el puerto 49817. Permita el acceso a la red local cuando el dispositivo lo solicite. Las pantallas continúan reproduciéndose a pesar de pérdidas de paquetes, ciclos de energía y particiones de red, y convergen nuevamente a medida que llegan las señales de página. Cada espera añadida se limita a 40 milisegundos. Las páginas largas y las grandes diferencias de tiempo tardan más en converger; esto sincroniza cambios de página en lugar de cuadros de video o pistas de audio.

Para acercar rápidamente una ubicación, pida a su agente que reinicie la reproducción en sus pantallas con screen reload --tag LOCATION, reemplazando LOCATION con su etiqueta compartida. Los Players reinician las listas de reproducción elegibles en la primera página y terminan la alineación mediante sus balizas regulares. El emparejamiento y el contenido descargado permanecen en su lugar.

Instalar un Player nativo

Cada descarga también está en la página de Descargas.

1. 01

   Instale el reproductor para su dispositivo pantalla.

2. 02

   Lánzalo. Se abre a pantalla completa y muestra un código de vinculación.

3. 03

   Dé el código de vinculación a su agente. Empareja la pantalla y publica en ella.

Cada reproductor nativo descarga el multimedia una vez, lo almacena en caché y lo reproduce desde el almacenamiento local.

Instale el APK de Android

Use el APK en Android TVs, dispositivos Google TV, tabletas y cajas de señalización con Android 9 o posterior que no usen Google Play. Úselo cuando instale por ADB.

El APK está firmado y es público. Es el mismo reproductor que la versión de Google Play. Su nombre de archivo incluye la versión, así que use https://screenrig.ai/android/manifest.json como único enlace al archivo actual.

Antes de comenzar, active las opciones de desarrollador y la depuración USB o de red en el dispositivo. También necesita adb en su computadora.

1. Conéctese al dispositivo. Para un dispositivo de red, ejecute adb connect DEVICE_IP:5555.

2. Descargue, verifique e instale el APK:

   curl -fsSL https://screenrig.ai/android/manifest.json -o manifest.json
   path=$(jq -r .player.path manifest.json); sha=$(jq -r .player.sha256 manifest.json)
   curl -fsSLO "https://screenrig.ai$path"
   echo "$sha  ${path##*/}" | sha256sum -c -
   adb install -r "${path##*/}"
   adb shell am start ai.screenrig.player

3. El reproductor abre pantalla completa y muestra un código de vinculación. Proporcione el código a su agente.

Iniciar al arrancar

Iniciar al arrancar está activado por defecto. Es un interruptor en la configuración del operador del Player: una vez que la pantalla está vinculada, presione OK en el control remoto para abrir el menú y elija Configuración. En Android 9 no se necesita permiso. En Android 10 y posteriores, conceda Mostrar sobre otras apps a menos que el dispositivo sea gestionado como propietario del dispositivo: seleccione Iniciar al arrancar y siga la indicación. Cuando hay una pantalla de permisos disponible, el Player lo solicita al mostrar por primera vez el código de vinculación: seleccione Abrir configuración y permita Mostrar sobre otras apps. Hasta que se conceda el permiso, la fila muestra Permiso requerido y el Player no inicia al arrancar. También puede concederlo con ADB:

adb shell cmd appops set ai.screenrig.player SYSTEM_ALERT_WINDOW allow

En Fire OS 8, use ADB para conceder este permiso; su pantalla de configuración no lo ofrece.

Protector de pantalla

En Android TV y Google TV, screenRIG es uno de los salvapantallas del televisor. Abra Salvapantallas en la Configuración del televisor y seleccione screenRIG. Cuando el televisor inicie su salvapantallas, el Player aparecerá al frente y reproducirá su contenido. No se necesita permiso.

Actualizando

Ejecute los pasos de instalación nuevamente. Android instala la versión superior sobre la instalada y mantiene su vinculación. Solo una versión superior reemplaza la instalada.

Google Play

El APK y la versión de Google Play comparten el paquete ai.screenrig.player. Si está instalada la versión de Google Play, desinstálela primero. Vuelva a vincular el reproductor después de instalar el APK.

Linux y Raspberry Pi

El reproductor Linux es un paquete autónomo para Linux de 64 bits, construido para PCs x86_64 y placas aarch64 como Raspberry Pi. Qt, Qt WebEngine y GStreamer están dentro del paquete. La máquina necesita la versión de glibc indicada para su arquitectura en screenrig.ai/linux/, una sesión Wayland o el compositor de kiosco cage, y sus propios controladores GPU, fuentes, certificados CA y servicio de audio.

Instálelo con el instalador, que selecciona la versión para la máquina y la verifica contra SHA256SUMS:

curl -fsSL https://screenrig.ai/linux/install.sh | sh

En una pantalla dedicada, agregue --kiosk (sh -s -- --kiosk) para iniciar el Player al arrancar dentro de cage bajo un servicio systemd. Ejecute el instalador nuevamente para actualizar, o con --uninstall para eliminarlo. Instalación manual: descargue screenrig-player-linux-x86_64.tar.gz o screenrig-player-linux-aarch64.tar.gz y SHA256SUMS desde screenrig.ai/linux/, verifíquelos con sha256sum --ignore-missing -c SHA256SUMS, extraiga a /opt/screenrig-player y ejecute /opt/screenrig-player/screenrig-player.

Debian 13, Raspberry Pi OS (trixie, 64 bits), Ubuntu, Fedora y Arch Linux ejecutan el Player cuando cumplen el requisito de glibc del paquete. Debian 12 y Raspberry Pi OS bookworm incluyen una glibc más antigua; actualícelos primero. Los paquetes por distribución para una instalación de kiosco están en las notas de descarga de Linux.

Raspberry Pi

Use Raspberry Pi OS (64 bits) basado en trixie; las imágenes de 32 bits y bookworm no pueden ejecutar el Player. Raspberry Pi 5 decodifica HEVC por hardware hasta 4K a 60 fps y no tiene decodificador H.264, así que suba cada video para él con screenrig media upload --codec hevc, de cualquier tamaño. Raspberry Pi 4 reproduce 1080p. Raspberry Pi OS Lite con --kiosk arranca directamente en el Player.

Mantenga la resolución elegida para la pantalla: un video HEVC 4K se reproduce en una salida de 1920×1080. Para actualizar un Player de Pi, vuelva a ejecutar el instalador de Linux con el prefijo de instalación y la cuenta del Player existentes; se conservan la vinculación y los ajustes de pantalla. Recargar una pantalla actualiza el contenido y no instala una nueva versión del Player.

Muros de video

Un Player maneja de 2 a 12 monitores como una pared: el Player Linux en una instalación --kiosk con wlr-randr (sudo apt install wlr-randr), y el Player Windows. Un Raspberry Pi 5 maneja dos monitores; un PC maneja tantos como permitan sus salidas gráficas, y un mini PC Intel como el Quieter 4C maneja hasta tres. El Player Windows organiza por sí mismo la disposición de monitores de Windows: posiciona y gira los monitores, y los refleja mediante el modo duplicado de Windows para una lista de reproducción sin format. Windows conserva su propio escalado de pantalla.

screen show lista las salidas de la pantalla, por ejemplo HDMI-A-1 en Linux o DISPLAY1 en Windows. Un muro puede ser row (de izquierda a derecha), column (de arriba a abajo) o grid. Una cuadrícula toma --columns, los monitores por fila, y llena al menos dos filas: 12 monitores en 4 columnas forman 3 filas. Los monitores se numeran de izquierda a derecha y luego de arriba a abajo, y --outputs nombra las salidas en ese orden. --rotation gira cada monitor en sentido horario 0 (predeterminado), 90, 180 o 270 grados; 90 y 270 son paneles verticales.

screenrig screen wall set SCREEN_ID --outputs HDMI-A-1,HDMI-A-2 --arrangement row [--rotation 0|90|180|270]
screenrig screen wall set SCREEN_ID --outputs DISPLAY1,DISPLAY2,DISPLAY3,DISPLAY4 --arrangement grid --columns 2
screenrig screen wall clear SCREEN_ID

Después de un cambio de pared, cada monitor muestra su número y nombre de salida durante 20 segundos, para que pueda verificar el orden.

Una lista de reproducción construida para la pared lleva un format (displays, arrangement, orientation y, para una cuadrícula, columns) y un lienzo de una página, en unidades de diseño 1080p por monitor: un mosaico es de 1920 × 1080 en horizontal o de 1080 × 1920 en vertical, y el lienzo es el mosaico por las columnas y filas. Un panel 4K no necesita nada diferente. Una pantalla reproduce una lista de reproducción de pared solo cuando su pared tiene la misma forma.

Coloque un elemento con displays: [1,2,3] abarca tres monitores en una fila, [2] se sienta en un monitor y [1,2] abarca dos. Los monitores llenan un rectángulo de la pared: en una cuadrícula de 4 columnas, [1,2,5,6] es el bloque superior izquierdo y [3,7,11] una columna de tres. O dé un rect libre en el lienzo de la pared. Una tarjeta se distribuye dentro de su displays, así que center en [2] se sienta en el medio del monitor 2; sin displays usa todos los monitores. En una pantalla con una pared, una playlist ordinaria (sin format) se reproduce reflejada en cada monitor.

Renderizar video de pared con la relación de aspecto de la pared dentro de 4K, como 3840 × 720 para tres monitores horizontales en fila, 3840 × 1080 para dos y 3840 × 1620 para una cuadrícula de 4 columnas y 3 filas, y colocarlo con content_fit: fill. Mantenga el texto y los rostros alejados de las uniones entre monitores.

{
  "name": "Lobby wall",
  "format": { "displays": 3, "arrangement": "row", "orientation": "landscape" },
  "pages": [
    {
      "id": "welcome",
      "canvas": { "width": 5760, "height": 1080, "background": "#000000FF" },
      "transition": { "type": "crossfade", "duration_ms": 500 },
      "advance": { "mode": "media_end" },
      "primitives": [
        {
          "id": "film",
          "primitive": "video",
          "selector": { "by": "id", "media_id": "med_01EXAMPLEWALL000000000" },
          "displays": [1, 2, 3],
          "layer": 0,
          "content_fit": "fill"
        },
        {
          "id": "menu",
          "primitive": "card",
          "card": "crd_01EXAMPLEMENU000000000",
          "layout": "center",
          "displays": [2],
          "content_fit": "fill"
        }
      ]
    }
  ]
}

Franjas

Una franja es una lista de reproducción dibujada sobre la página a lo largo de un borde de una pantalla, como un teletipo inferior o un logotipo superior. La página sigue reproduciéndose debajo; la franja oculta la parte que cubre. Una franja se hace para una región: header (el borde superior), footer (el borde inferior) o side (el borde derecho, a toda la altura).

Una lista de reproducción de franja es una lista de región: lleva format: {"region": "footer", "orientation": "landscape"}, donde orientation es la orientación de la pantalla para la que se hace, tal como la ve el espectador. Tiene un único lienzo de franja, con la forma de su borde: el lado largo va a lo largo del borde y mide al menos el doble que el corto, como 1920 × 240 para un pie o una cabecera en horizontal y 240 × 1080 para un lateral en horizontal. Una franja contiene solo elementos de imagen y tarjeta, sin video, transmisión, iframe, aplicación ni espacio publicitario, y no tiene banda sonora. Una franja nunca es una lista de reproducción predeterminada ni una toma de control.

screenrig playlist create ticker.json --format-region footer --format-orientation landscape
screenrig campaign create --name Ticker --playlist-id pl_TICKER --tag lobby --covers footer

Una campaña o una entrada de programación muestra una franja mediante covers: footer, header o side reproduce una franja de esa región, y full (el valor predeterminado) o main reproduce una lista de reproducción ordinaria como página. Un nivel que cubre una región necesita una lista de reproducción hecha para esa región.

La franja conserva la proporción de su lienzo y recorre el borde de cada pantalla de su orientación, tras la rotación, y cubre como máximo la mitad de la pantalla. Una pantalla de la otra orientación muestra solo la página, y también una pantalla que la franja cubriría en más de la mitad (su altura en una cabecera o un pie, su ancho en un lateral). La barra de alerta de un activador de superposición se dibuja encima de una franja. Una campaña o entrada que no cabe en ninguna de las pantallas a las que se dirige se rechaza (playlist_format_mismatch); en una pantalla de una audiencia mixta donde no cabe, campaign explain informa region_not_laid_out y la pantalla muestra la página. Cambiar una lista de reproducción a una región, fuera de ella o a otra región se rechaza mientras una pantalla, carpeta o campaña la use.

Instale la app web del reproductor

1. 01

   Abra play.screenrig.ai/player/ en el dispositivo de la pantalla.

2. 02

   En iOS, use Safari: Compartir → Agregar a pantalla de inicio. En Android, use Chrome: Instalar app o Agregar a pantalla de inicio.

3. 03

   Abra la PWA instalada y siga sus instrucciones de configuración mostradas.

4. 04

   Mantener la PWA en primer plano en el dispositivo de pantalla.

Inicie un navegador de kiosco con la reproducción automática permitida (Chrome --autoplay-policy=no-user-gesture-required, Autoplay Audio de Fully Kiosk) y la app web del Player reproduce el sonido de inmediato; un navegador que rechaza el sonido reproduce el vídeo sin sonido, y el registro del Player lo indica.

Un Player se empareja con la API de su propio entorno: play.screenrig.ai con api.screenrig.ai. Cuando la CLI usa otro origen de API, --api-url https://api.DOMAIN, abra https://play.DOMAIN/player/ en su lugar.

Su agente necesita el plugin oficial para publicar contenido en el Player.

Aplicaciones en la red local

Una aplicación puede llamar a direcciones http:// y ws:// de la propia red de la pantalla, como un controlador en http://192.168.1.20. En un navegador de kiosco, el propietario del navegador lo permite. En Chrome y Edge 142 y posteriores, establezca la política empresarial LocalNetworkAccessAllowedForUrls en https://play.screenrig.ai: el Player concede ese permiso a las aplicaciones que enmarca, y las direcciones IP privadas y los nombres .local se cargan entonces por http y ws, con fetch y las imágenes incluidos. Para otros nombres de host http://, establezca también InsecureContentAllowedForUrls en https://play.screenrig.ai, o elija Contenido no seguro: Permitir en la configuración del sitio. Ambas políticas nombran la página del Player, no la dirección de la aplicación. Acceder a dispositivos de la red de la pantalla trata las imágenes y CORS.

Kiosco ChromeOS

Los dispositivos ChromeOS gestionados, como un Chromebox, Chromebase o una PC ChromeOS Flex, ejecutan la aplicación Player web como una aplicación quiosco desde la consola de administración de Google. El dispositivo arranca directamente en el Player, lo mantiene en pantalla completa y lo inicia nuevamente si se cierra.

1. 01

   En la consola de administración de Google, abra Dispositivos → Chrome → Apps y extensiones → Kioscos y seleccione la unidad organizativa para sus pantallas.

2. 02

   Agregue la app por URL: el enlace de flota de su proyecto, o https://play.screenrig.ai/player/ con la barra diagonal final para emparejar cada dispositivo por su código.

3. 03

   Establézcalo para que se inicie automáticamente y active Permitir que la aplicación administre la energía.

4. 04

   En la configuración de energía del kiosco del dispositivo, configure la acción de inactividad en No hacer nada, para que la pantalla nunca se atenúe ni entre en suspensión.

5. 05

   Reinicie el dispositivo. Con un enlace de flota, el reproductor se une a su proyecto como una nueva pantalla por sí solo. Sin uno, muestra su código de vinculación: entregue el código a su agente.

En la sesión del kiosco, el Player lee el número de serie del dispositivo y el ID de activo y ubicación que anotó en el dispositivo en la consola de administración. Aparecen en los detalles del host de la pantalla en el panel y en screen show. Cuando un restablecimiento o reinstalación da al dispositivo una nueva identidad de Player, el número de serie permite que su agente lo reconecte a su pantalla existente con screen recover en lugar de emparejar una nueva.

Para la banda sonora, permita reproducción automática para https://play.screenrig.ai con la política AutoplayAllowlist.

Una URL para toda la flota

Un enlace de flota es una URL de Player que convierte cada dispositivo que la abre en su propia pantalla en su proyecto, sin código de vinculación. Solicite uno a su agente (screenrig fleet-links create), o créelo en el panel bajo Configuración → Enlaces de flota, y coloque su URL en la app kiosco en el paso 2. Cada nuevo dispositivo se une con las etiquetas y lista de reproducción del enlace y toma su nombre del ID del activo, luego la ubicación que anote en la consola de administración.

Un dispositivo que ya es una pantalla permanece como esa pantalla tras reinicios y actualizaciones. Después de un restablecimiento o reinstalación vuelve como la misma pantalla, una vez que su antigua identidad Player ha estado inactiva diez minutos. Limite un enlace con un máximo de pantallas, apáguelo para impedir que nuevas pantallas se unan, o gírelo para reemplazar una URL compartida demasiado ampliamente. Las pantallas que un enlace ya creó siguen reproduciendo en los tres casos. Mantenga la URL en la consola Admin: crea pantallas en su proyecto.

Encendido de pantalla por RS-232

Conecte el puerto de control RS-232 del monitor al dispositivo ChromeOS con un adaptador serial USB, y otorgue el adaptador a https://play.screenrig.ai con la política SerialAllowUsbDevicesForUrls (los IDs de proveedor y producto USB del adaptador) o SerialAllowAllPortsForUrls. Al iniciar, el Player encuentra un monitor Samsung (MDC), LG, NEC o Philips (SICP) en el puerto otorgado a la velocidad predeterminada de fábrica de 9600 baudios y el ID del monitor. Luego cambia la energía propia del monitor, el modo de espera y lo vuelve a encender, y reporta el estado de energía que el monitor devuelve. La lista de capacidades del host de la pantalla incluye Energía del monitor (RS-232).

Enlaces de flota en un administrador de dispositivos

La URL de un enlace de flota (panel Configuración → Enlaces de flota, o screenrig fleet-links create) también se coloca en su administrador de dispositivos:

• Android, Google TV y Amazon Signage Stick. En su EMM o administrador de dispositivos, defina la clave fleet_link en la configuración administrada de la app (paquete ai.screenrig.player).
• Apple (Mac, Apple TV, iPhone y iPad). En su MDM, defina la clave fleet_link en la configuración de app administrada.
• Linux y Raspberry Pi. Coloque la URL en el archivo /etc/screenrig/fleet-link, o agregue --fleet-link URL al instalador (sh -s -- --kiosk --fleet-link URL).

En Android y Apple, las claves opcionales asset_id y location nombran la nueva pantalla (primero el ID de activo), y serial permite que un dispositivo reinstalado recupere su pantalla.

Un dispositivo sin pantalla se une por sí solo al proyecto del enlace. Un dispositivo cuyo enlace ya no funciona (rotado, desactivado, lleno o vencido) muestra su código de vinculación con una línea que explica el motivo. Mantenga la URL en el administrador de dispositivos: crea pantallas en su proyecto.

Un enlace de flota puede terminar en el momento que usted elija: pase --expires-at (por ejemplo, 2027-12-31T23:59:59Z) a screenrig fleet-links create o update, o complete el campo Vence en el panel. Después de ese momento, los dispositivos nuevos muestran su código de vinculación, y las pantallas que creó el enlace siguen reproduciendo.

Propietario del dispositivo Android con un código QR

Un dispositivo Android 10 o posterior con cámara y restablecido de fábrica se une a un enlace de flota sin administrador de dispositivos. Abra el enlace en el panel (Configuración → Enlaces de flota), elija Mostrar código QR en Propietario del dispositivo Android, toque seis veces la pantalla de bienvenida del dispositivo y escanee el código. El dispositivo descarga el Player administrado, lo comprueba con el certificado de firma del código, lo instala como propietario del dispositivo y se une al proyecto del enlace sin código de vinculación. Después, el Player se ejecuta como aplicación de inicio del dispositivo, a pantalla completa, sin barra de navegación, notificaciones ni pantalla de bloqueo.

El código lleva una carga de aprovisionamiento, y Copiar JSON de aprovisionamiento la copia para un administrador de dispositivos que aprovisiona desde JSON. Su agente imprime la misma carga con screenrig fleet-links show ID --android-provisioning (requiere un inicio de sesión Manage, porque la carga contiene el secreto del enlace), lista para codificarla como código QR. La carga es así:

{
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME": "PACKAGE/ai.screenrig.player.managed.ScreenRigDeviceAdminReceiver",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION": "DOWNLOAD_URL",
  "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM": "CHECKSUM",
  "android.app.extra.PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED": true,
  "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE": { "fleet_link": "FLEET_LINK_SECRET" }
}

PACKAGE, DOWNLOAD_URL y CHECKSUM provienen de la entrada managed de https://screenrig.ai/android/manifest.json: su package, https://screenrig.ai seguido de su path, y su signer_sha256 en base64 seguro para URL y sin relleno. FLEET_LINK_SECRET es la parte de la URL del enlace que va después de #fleet=. El archivo tiene versión y se conserva, y la suma de comprobación pertenece al certificado de firma, así que un código impreso sigue funcionando cuando se publica un Player más reciente. El código contiene el secreto del enlace: compártalo solo con la persona que configura el dispositivo.

Fuentes de navegador (vMix, OBS)

Una fuente de navegador no conserva almacenamiento, por lo que el Player que contiene perdería su vinculación cada vez que carga. Un enlace de pantalla es la dirección de una sola pantalla: el Player abierto desde él es esa pantalla en cada carga, sin conservar nada. Úselo para una fuente de navegador de vMix u OBS, o para cualquier navegador que borre sus datos.

1. 01

   Vincule la pantalla una vez. Abra la app web del Player en cualquier navegador, dé a su agente el código que muestra y espere hasta que la pantalla esté activa.

2. 02

   Solicite a su agente el enlace de la pantalla (screenrig screen link create SCREEN_ID), o abra la pantalla en el panel y elija Crear enlace en la fila Enlace de pantalla de su pestaña Propiedades.

3. 03

   Copie el enlace: su agente lo imprime con screenrig screen link show SCREEN_ID, o elija Copiar enlace en el panel. Es https://play.screenrig.ai/player/#screen= seguido de un secreto.

4. 04

   Péguelo como la URL de la fuente de navegador.

5. 05

   La fuente reproduce de inmediato la lista de reproducción de la pantalla, y de nuevo tras cada recarga.

Abra un enlace de pantalla en un solo lugar. Abierto en dos, es una pantalla dos veces. Varias fuentes de navegador en un mismo navegador, cada una con su propio enlace, funcionan como pantallas separadas.

Un enlace de pantalla es una credencial: quien lo tiene abre esa pantalla. Si se filtra, o quiere recuperarlo, solicite el enlace de nuevo (screenrig screen link create SCREEN_ID, o Reemplazar enlace): la dirección anterior deja de funcionar de inmediato y una fuente que aún la muestra presenta un aviso y ningún contenido, sin código de vinculación. Pegue la nueva dirección y la fuente vuelve a reproducir. Desactivar enlace (screenrig screen link delete SCREEN_ID) termina el enlace sin crear otro. El Player propio de la pantalla, si lo tiene, no se ve afectado en ningún caso.

Publicidad en sus pantallas

El reproductor que ya usa también es el reproductor de anuncios: no hay nada extra que instalar.

Vender es una opción que hace por pantalla, mediante el mismo plugin oficial y CLI. Incluya una pantalla propia con screenrig ads inventory update scr_LOBBY --enabled y descríbala públicamente con el nombre del sitio, ciudad, región, tipo de lugar y etiquetas de audiencia que elija. Defina espacios publicitarios reutilizables con screenrig ads slots create — medios aceptados (imagen o video), las duraciones máximas de imagen y video, y una tarifa opcional para ese espacio. Solo la definición de un espacio no cambia nada en la pantalla; colocar su página de espacio publicitario en una de sus listas de reproducción es lo que da a esa pantalla una pausa publicitaria real, y todas las demás páginas siguen reproduciéndose normalmente.

Los anuncios pagados requieren un Player que soporte reproducción de adslot. El servidor sirve a un Player sin ese soporte solo la lista de reproducción ordinaria, para que esa pantalla reproduzca contenido propio y no publicidad pagada; un Player capaz solicita un relleno para cada página de adslot y omite cualquier espacio que no pueda llenar, manteniendo la lista de reproducción en movimiento. Los compradores no vinculan nada: compran de su inventario mediante la invitación que envía con screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY.

El plugin, proyecto y pasos para la primera pantalla están en la Guía de inicio.

Pantallas comerciales

Samsung Smart Signage (Tizen) ejecuta el reproductor nativo screenRIG.

Los reproductores BrightSign con SO 9.1 o superior inician automáticamente el Player de screenRIG desde una tarjeta SD. Extraiga el paquete a la raíz de la tarjeta, insértela y encienda. El reproductor aplica su política de hardware y abre el Player de screenRIG.

1. 01

   Configure primero el reloj y la red del reproductor. Un reloj incorrecto detiene la conexión segura.

2. 02

   Extráigalo a la raíz de una tarjeta SD FAT32 e inserte la tarjeta.

3. 03

   Encienda el reproductor. Inicia el paquete y muestra el código de emparejamiento.

4. 04

   Dé el código a su agente.

LG webOS Signage

Las pantallas LG webOS Signage con la versión 6.0 o posterior (Chromium 79 o posterior) ejecutan el reproductor screenRIG. Una aplicación instalada se inicia al encender y lo abre. Las pantallas con webOS Signage 4.x o anterior usan un navegador más antiguo de lo que el reproductor necesita. Descargue los paquetes desde screenrig.ai/webos/.

Una pantalla en modo de inicio de aplicación Local instala com.lg.app.signage.ipk desde una memoria USB.

1. 01

   Configure primero la fecha, la hora y la red de la pantalla. Un reloj incorrecto detiene la instalación con «Unknown error» y detiene la conexión segura.

2. 02

   En una memoria USB FAT32, cree en la raíz una carpeta llamada application y coloque en ella com.lg.app.signage.ipk. Conserve el nombre del archivo.

3. 03

   Conecte la memoria a la pantalla. En Server Settings, ajuste Application Launch Mode en Local y el tipo en IPK, y ejecute Local Application Upgrade desde USB.

4. 04

   Reinicie la pantalla. Inicia la aplicación y muestra el código de emparejamiento.

5. 05

   Dé el código a su agente.

Para instalar desde el menú de aplicaciones de la pantalla o desde un servidor SI, use ScreenRig-webos.ipk en su lugar. Los dos paquetes son aplicaciones distintas para la pantalla, cada una con su propio emparejamiento, así que instale solo uno en cada pantalla.

Una pantalla que arranca antes de que su red esté lista muestra la pantalla de screenRIG y sigue intentándolo hasta que el reproductor responde. Pulse Info en el mando a distancia para ver el modelo de la pantalla, la versión del navegador y el estado de la conexión.

Otros monitores comerciales con navegador HTML5 integrado o lanzador de URL pueden abrir play.screenrig.ai/player/ directamente y seguir los pasos de la aplicación web arriba mencionados. El monitor debe mantener la página en primer plano y permitir que almacene datos. Android TV y cajas de streaming con navegador web completo pueden hacer lo mismo: abrir play.screenrig.ai/player/ en el navegador de la caja, dar a su agente el código de vinculación y mantener la página en primer plano.

Transmisiones e imágenes de respaldo

Use stream para una transmisión en vivo y video para un archivo subido. Una transmisión necesita una imagen subida lista de la misma cuenta como reserva. La imagen aparece mientras se conecta, si la reproducción se detiene o cuando el Player no puede recibir la fuente.

Preparar un feed

Use una lista de reproducción HTTPS pública HLS sin credenciales incrustadas, o la URL RTSP de una cámara. Para el Web Player, la lista, segmentos y claves deben permitir solicitudes cross-origin desde el origen del Player. Video H.264 con audio AAC es un perfil inicial práctico; la decodificación depende del dispositivo. El audio está silenciado por defecto y las reglas de reproducción automática del navegador aún aplican.

Elija el tiempo y el transporte

Use como máximo una transmisión por página y avance basado en duración. Proporcione una o dos fuentes con diferentes protocolos, en orden de preferencia. Una fuente puede dar solo su url: una URL https es HLS, una URL rtsp o rtsps es RTSP. Para multicast, use un grupo IPv4 con alcance administrativo en 239/8 y un puerto UDP; agregue una alternativa HLS para otros Players. screenRIG no convierte multicast en HLS. Las transmisiones no se almacenan en caché para reproducción sin conexión; la imagen de reserva sí.

Reproducir una cámara directamente

Los Players de Android, Amazon y Linux abren por sí mismos las fuentes de cámara rtsp://, desde la propia red del Player, sin relé. Use la URL proporcionada por la cámara o el grabador, incluidas las credenciales user:pass@. Linux también abre fuentes rtsps://.

Para una cámara UniFi Protect, active RTSP para un canal en los ajustes de Protect de la cámara y copie su URL. Android y Amazon convierten la URL rtsps:// de Protect del puerto 7441 en rtsp:// sin cifrar en el puerto 7447, eliminando enableSrtp. El Player necesita acceso al puerto 7447 de la consola de Protect; esta conexión no usa TLS ni SRTP. Para otras fuentes RTSPS cifradas en Android y Amazon, use una alternativa HLS o la imagen de reserva. Otros Players reproducen la alternativa HLS o muestran la imagen de reserva.

Habilitar recepción multicast

En Android, abra el menú del operador, elija Configuración y active las transmisiones Multicast; está desactivado por defecto. En Qt, active SCREENRIG_ENABLE_MULTICAST=1 en el entorno de lanzamiento del Player y verifique --capabilities-json. La red debe transportar el grupo multicast y puerto seleccionados. Esta versión no proporciona DRM, RTP, encabezados de autenticación personalizados ni transcodificación de flujo.

Bandas sonoras

Una banda sonora de lista de reproducción se reproduce en cada Player. El Player descarga y verifica cada pista MP3 con el resto de la lista, luego reproduce las pistas en orden mientras cambian las páginas. Las transiciones de página nunca detienen ni reinician la música, y la banda sonora sigue reproduciéndose offline desde las pistas en caché. Una banda sonora señalada (cued: true) reproduce una pista solo cuando una señal de página la inicia y está en silencio después de que esa pista termina hasta la siguiente señal. Una página cuyo advance es audio_end termina cuando su pista señalada termina; si el Player no puede reproducir la pista, la página dura la longitud de la pista.

Cuando el agente vuelve a publicar la lista de reproducción, la pista actual sigue reproduciéndose si todavía está en la nueva banda sonora. El volumen de la banda sonora se multiplica por el volumen del Player, por lo que la configuración de volumen del operador o el control de volumen propio del monitor aún deciden qué tan alto se escucha la pantalla.

Los navegadores pueden bloquear el sonido hasta que alguien toque la página. La app web del Player sigue mostrando páginas y comienza la banda sonora en el primer toque o pulsación de tecla. Para un navegador de kiosco sin atención, permita la reproducción automática con sonido; en Chromium, inicie con --autoplay-policy=no-user-gesture-required; en un kiosco ChromeOS, configure la política AutoplayAllowlist. Los Players nativos no requieren configuración.

Estado del dispositivo y control del monitor

Cada Player informa la salud del dispositivo cada quince minutos, y de inmediato cuando cambia su conexión de pantalla o energía. Declara los controles de dispositivo que soporta: reinicio remoto y los métodos de energía de pantalla que puede usar. Lo que un Player puede leer y cambiar depende de la plataforma y de cómo está configurado el dispositivo.

Las capacidades reales de cada pantalla aparecen en screen show como sus capacidades de host, junto a su informe de estado más reciente, para que el agente sepa antes de actuar si esa pantalla puede reiniciarse o cambiar su monitor. La tabla muestra lo que cada reproductor puede hacer.

Acciones remotas

Tres controles más del dispositivo llegan a un Player como comandos: borrar sus cachés, reiniciar su aplicación (no el dispositivo) y actualizarlo a la versión más reciente. Un Player declara clear_cache, restart_app o update en sus capacidades de host solo donde el comportamiento funciona en ese dispositivo, de modo que screen show informa al agente antes de actuar; una pantalla cuyo Player no declara la capacidad responde command_unsupported y no se envía nada. Borrar la caché conserva la vinculación y los ajustes y repone el contenido desde el manifiesto. Cada comando aparece en commands en screen show, done o failed con la causa que informa el Player.

Oscurecimiento por inactividad, brillo automático y bloqueo de kiosco

Tres ajustes de pantalla controlan el vidrio en el propio dispositivo. Un Player aplica uno cuando screen show incluye su capacidad del host (display_power.idle, brightness.auto o kiosk_lock); el ajuste se guarda en ambos casos.

• Oscurecimiento por inactividad. Tras 30 a 86400 segundos sin un toque ni una tecla o, cuando presence es un evento de activación, sin nadie frente a la pantalla, la pantalla se oscurece y la reproducción se pausa. Un toque o la presencia, según elija, la vuelve a encender; el toque que activa una pantalla oscura no llega más lejos. La presencia lee la cámara del dispositivo en el propio dispositivo, y ninguna imagen sale de él. Un horario o una anulación de pantalla que mantiene el monitor apagado prevalece.
• Brillo automático. auto ajusta el brillo según el sensor de luz del dispositivo; fixed, el valor predeterminado, mantiene el brillo del operador. Un dispositivo declara brightness.auto solo cuando tiene un sensor de luz.
• Bloqueo de kiosco. El Player Android se fija a la pantalla con la fijación de pantalla, sin necesidad de propietario del dispositivo. La persona que está frente a la pantalla lo confirma la primera vez, y la barra de estado, el botón de inicio y las aplicaciones recientes quedan bloqueados mientras dura.

Su agente los define con screen display-idle, screen brightness y screen kiosk-lock. La pestaña Propiedades de la página de la pantalla en el panel tiene los mismos tres en Configuración del dispositivo.

Vista en directo

La vista en directo muestra en el dashboard, como vídeo, lo que reproduce una pantalla, y screenrig screen live frame guarda imágenes JPEG de ella para un agente que solo dispone de HTTPS. El reproductor de Android (Google Play y Amazon Signage Stick), Linux y Raspberry Pi la publican, y una pantalla que puede hacerlo muestra la capacidad de host live_view en screen show. En Android, una persona junto a la pantalla permite la captura de pantalla una sola vez cada vez que se inicia el reproductor. Una sesión en directo termina sola cuando vence su plazo; vuelve a iniciarla para seguir viendo.

Controlar una pantalla en el dispositivo

Una vez emparejada la pantalla, presione OK en el control remoto para abrir su menú del operador. La primera pantalla del menú contiene:

• Nombre de la pantalla. Selecciónelo para renombrar la pantalla.
• Lista de reproducción. Su pista es la lista que la pantalla reproduce. Selecciónela, o presione Derecha, para listar todas las listas de reproducción del proyecto en orden alfabético y elija una para cambiar la pantalla a ella. Un takeover, una campaña o una programación de lista aún decide qué se reproduce; la pista siempre nombra lo que está reproduciéndose.
• Página. Su pista es el nombre de la página que se muestra ahora; el nombre de una página es su identificador. El menú se abre en esta fila. Presione Izquierda o Derecha para ir a la página anterior o siguiente, o selecciónela para listar las páginas de la lista de reproducción en orden de reproducción y elegir una para saltar. La página elegida comienza desde su inicio.
• Configuración. Brillo, volumen y reinicio, y en Android recepción multicast y arranque al encender.
• Salir de configuración cierra el menú desde cualquier pantalla.

Volver, o Izquierda en una lista, regresa a la pantalla anterior. El menú se cierra solo después de 60 segundos sin entrada.

Pausar y reanudar

Presione Reproducir/Pausa en el control remoto (K en Windows) para pausar la pantalla; aparece el chip Pausado. Una pantalla pausada mantiene su temporizador de página, el video de la página y la banda sonora. Presione el botón nuevamente y todo continúa desde donde se detuvo: una página configurada para mostrarse durante 20 segundos, pausada en 10 segundos, se muestra durante los 10 segundos restantes, y la música se reanuda desde el mismo punto en lugar de comenzar de nuevo. Pasar a la página siguiente o anterior, o elegir una en el menú, mantiene la pausa: la nueva página espera en su inicio hasta que reanude. Las tarjetas, páginas web y transmisiones en vivo siguen funcionando mientras está pausado. Una pausa termina sola después de 60 minutos.

Verifique su primera pantalla

Dé a su agente la pantalla prevista y pídale que publique un mensaje de bienvenida simple. Solicite una captura de pantalla cuando el reproductor lo muestre.

Si la pantalla no aparece en la lista del agente, confirme que el Player está abierto y su configuración está completa. Si el contenido no se actualiza, verifique la conexión del dispositivo y pida al agente que inspeccione el estado de la pantalla y la evidencia de reproducción.

Un chip en la pantalla, o un código en screen show, se explica en Códigos de estado del Player.

Una vez emparejada la pantalla, su menú del operador nombra la pantalla y muestra su playlist y página.

Continuar con el flujo de trabajo del agente.