Códigos de estado del Player

Dónde aparecen los códigos

Un chip es un icono en la esquina inferior izquierda de la pantalla, con un mensaje de una línea cuando aparece por primera vez. El Player muestra la condición activa de mayor rango y mantiene el chip mientras la condición se cumple. El panel muestra el chip junto al estado en línea de la pantalla.

screenrig screen show scr_ID devuelve lo que informó el Player:

Un chip es el último informe del Player: léalo como obsoleto mientras online sea falso. Informes como player.video_unusable y player.card_failed van al registro del Player de la pantalla:

screenrig events list --source log --screen-id scr_ID

Chips de estado

La tabla sigue el orden de rango: cuando se cumplen varias condiciones, se muestra la primera. La etiqueta es el nombre del chip en el panel.

Actualización del reproductor necesaria es un aviso junto al chip, no un chip. Aparece cuando la versión del Player está por debajo del mínimo compatible con screenRIG, y el Player sigue reproduciendo su contenido guardado. Actualice el Player con screenrig screen update-software scr_ID donde declara update; de lo contrario, desde su tienda o administrador de dispositivos.

Video que no se reproduce

Un Player decodifica el video con el decodificador por hardware del dispositivo para el códec, el perfil y la resolución del archivo. Cuando el dispositivo no puede, el Player omite el elemento: el chip es decode_miss, o decode_unplayable cuando no hay nada más en pantalla. La entrada player.video_unusable del registro del Player indica el valor de code (video_load_failed, video_play_failed, video_autoplay_blocked, video_stalled, image_load_failed, video_prepare_failed, video_first_frame_timeout o video_decode_failed) junto con decoder, codecs, width y height, medidos por el Player.

screenrig media upload ./lobby-loop.mp4 --codec hevc
screenrig media upload ./lobby-loop.mp4 --preset signage-1080p30

Un video se sube como H.264 de forma predeterminada. Una Raspberry Pi 5 no tiene decodificador H.264: suba con --codec hevc todo video para ella, de cualquier tamaño. Una Raspberry Pi 4 reproduce 1080p, y --preset signage-1080p30 limita el tamaño. Use hevc solo cuando todas las pantallas que reproducen el clip sean Players nativos. Reemplace el elemento multimedia en la lista de reproducción y vuelva a publicarla.

Asignar una lista de reproducción cuyo video es todo H.264 a una pantalla cuyo Player declara video.h264_unavailable se rechaza con invalid_request. En contenido mixto, ese Player omite los elementos H.264.

Fallos de página y de actualización

Una página que no puede quedar lista se omite y el Player sigue reproduciendo sus otras páginas. Informa del fallo, y last_page_failure.code es el código propio del Player. screenrig events list --type playback.page_failed --screen-id scr_ID los enumera.

manifest_upgrade.state indica cómo avanza una actualización de contenido:

manifest_upgrade.code indica la causa de un estado retrying, failed, blocked o partial:

Caché y almacenamiento

Antes de descargar una revisión, un Player planifica su almacenamiento: qué archivos de páginas caben en el espacio que puede usar. Un Player nativo deja libres 128 MiB de su volumen y se mantiene dentro de cualquier cuota establecida para él. Al iniciar, un Player con menos de 512 MiB libres muestra un mensaje con el espacio libre; ese mensaje no es un chip.

storage.plan.fit en screen show indica cómo cabe la lista de reproducción:

manifest_upgrade.code repite el plan: none_fit o transition_blocked para una actualización blocked, capacity para una actualización partial cuyas páginas no cupieron, staged para una actualización partial que aún se está llenando, y storage_full cuando falla una escritura. storage_shortfall está presente mientras fit es partial, transition_blocked o none_fit.

Cada entrada de excluded_pages incluye reason:

Consulte antes de asignar una lista de reproducción grande:

screenrig screen storage-forecast scr_ID --playlist-id pl_ID

Responde fits, partial, none_fit o unknown, con los bytes que necesita la lista de reproducción y la capacidad del Player. unknown significa que la pantalla nunca ha informado su almacenamiento. Un informe de más de 24 horas se marca como obsoleto. El comando no escribe nada. Cuando aparece un fallo de almacenamiento, la respuesta incluye una advertencia storage_full: libere almacenamiento en el dispositivo que ejecuta el Player y después reintente con la lista de reproducción.

Tarjetas

Una tarjeta que no puede dibujarse deja su rectángulo vacío y la página sigue reproduciéndose. El Player registra card.failed, y los Players web, Android y Windows informan player.card_failed una vez por cada tarjeta de una página y código, con page_id, primitive_id, manifest_revision y code. Una tarjeta cuyos datos expiraron también queda en blanco: screenrig card data put --ttl 30m la renueva.