Guía de operación — Pantallas La Providencia

Esta página vive en el panel (/ayuda) y funciona desde el celular. Sugerencia: imprime la sección "Diagnóstico rápido" y pégala junto a cada TV.

Subir un video nuevo

Entra al panel → pestaña Videos → ⬆ Subir video.
Espera la barra de progreso; al terminar verás la miniatura y la duración.
Ve a Playlists, elige la playlist de la pantalla, Agregar el video, arrástralo al lugar que quieras y 💾 Guardar cambios.
La pantalla lo toma sola en menos de 5 minutos (no hay que tocar la TV).

Si sale la advertencia "⚠ Códec fuera de perfil": el video no viene del pipeline normal — normalízalo en la PC (H.264/AAC 1080p) y súbelo de nuevo.

Cambiar el orden, quitar o desactivar videos

En Playlists: arrastra con el símbolo ☰ para reordenar; el interruptor "activo" lo saca de la rotación SIN borrarlo; ✕ lo quita de la lista. Siempre termina con 💾 Guardar cambios.

Reglas ("este video cada N videos o cada X minutos")

En Playlists → Reglas de inserción: elige el video, el tipo de regla, el valor y la prioridad → Agregar regla → 💾 Guardar.

La prioridad menor gana cuando varias reglas disparan a la vez.
"Cada X minutos" espera a que termine el video en curso — nunca lo corta.
Si el video de la regla también está en la lista, se verá más seguido de lo que esperas (cuenta doble: por lista y por regla).
Usa 👁 Próximos 10 para ver un ejemplo del orden resultante. Es un ejemplo desde el inicio de un ciclo — la pantalla puede ir en otro punto.

Agregar una pantalla nueva

Pestaña Pantallas → ＋ Agregar → asignarle playlist → 🔗 Código de emparejamiento → teclear el código en la TV (vence en 15 min). Para preparar la box desde cero, sigue SETUP-CAJA.md (documento técnico del repo).

Diagnóstico rápido (¿qué significa el color de cada pantalla?)

Señal	Significado	Qué hacer
🟢 Reproduciendo	Todo bien	Nada
🟡 App cerrada	La box está prendida pero alguien salió de la app (la usaron para otra cosa)	En la TV: botón HOME → abrir Pantallas La Providencia (reanuda sola)
🔴 Sin conexión	La box no reporta desde hace >40 min	1) ¿La box tiene luz/corriente? 2) ¿El internet de la tienda funciona? 3) Desconecta y reconecta la corriente de la box: la app abre sola (o ábrela con el control: 2 clics)
TODAS 🔴 a la vez	No son las tiendas: es el servidor	Las pantallas SIGUEN reproduciendo solas (funcionan sin internet). Revisar el VPS/n8n con calma
Pantalla negra pero el panel dice 🟢	La TV está apagada o en otra entrada HDMI — la box sí está reproduciendo	Prender la TV y elegir la entrada HDMI correcta
🔴 y la app "desapareció" de la box	Play Protect pudo deshabilitarla	En la box: Play Store → Play Protect → volver a habilitar la app; reabrir

Nota force-stop: si alguien "fuerza detención" de la app en Ajustes de la box, Android no permite que reviva sola — hay que abrirla manualmente una vez.

Actualizar la app de las pantallas (OTA)

Ajustes → Actualización de la app: sube el APK con su versión.
Activa "recibir actualizaciones" en UNA pantalla primero (la de prueba).
En esa TV aparecerá el diálogo → Instalar con el control → la app se relanza sola. Verifica que reproduce bien.
Ya probado, activa el toggle en las demás pantallas. (Desde la segunda actualización, muchas boxes ya no muestran el diálogo.)

Respaldo y desastre

El respaldo de configuración se descarga en Ajustes (y n8n manda uno diario solo). Los videos NO van ahí: se recuperan de los originales de la PC con rehidratar.ps1, y los subidos solo desde el cel, del respaldo de Drive.
Restaurar: Ajustes → Restaurar desde respaldo con el .tar.gz — las pantallas NO se des-emparejan.
Si pierdes el celular o sospechas de un acceso: rota JWT_SECRET en el servidor y reinicia el contenedor — todas las sesiones del panel se cierran (las pantallas siguen como si nada).

Reglas de oro

Los videos se producen en la PC con el pipeline de siempre (H.264 1080p).
Todo cambio de contenido se hace desde el panel — nunca con USB en la box.
APK nuevo SIEMPRE se prueba primero en una sola pantalla.
Ante cualquier duda con una pantalla: corriente fuera, esperar 10 s, corriente dentro. La app se levanta sola con todo su contenido local.

← Volver al panel