Agente Android — Configuración
Los ajustes están protegidos por contraseña. Para abrirlos: toca 4 veces sobre el fondo y elige nivel Admin o Usuario.
Ajustes que se gestionan desde el panel web
Estos valores los gestionas en Panel → Dispositivos → Editar kiosk, no en el dispositivo. El agente los recibe en su próximo heartbeat:
- Modo Web Kiosk vs Playlist
- URL de inicio (modo Web Kiosk)
- Whitelist de URLs (modo Web Kiosk)
- Playlist asignada (modo Playlist)
- Contraseña del menú admin
Ajustes que se gestionan en el dispositivo
Estos sólo pueden tocarse desde los ajustes locales del agente (nivel Admin):
| Ajuste | Descripción |
|---|---|
| URL del servidor | Endpoint base RDS. Por defecto https://rds.digitalsignagerds.com. |
| ID del dispositivo | Código RDSXXXX asignado en el panel. Sin esto el agente no puede autenticarse. |
| Intervalo de sync | Tiempo entre heartbeats / comprobaciones de contenido nuevo. |
| Ruta de almacenamiento | Dónde guardar la caché local de vídeos e imágenes (típicamente almacenamiento externo). |
| Modo de visualización | Pantalla completa con stretch o letterbox según el aspect ratio del vídeo. |
| Volumen | Slider de volumen del player. |
Contraseña admin
Dos niveles:
- Admin (
contrassenya_settings) — control total. - Usuario (
contraUser_settings) — sólo ver información.
La contraseña por defecto de fábrica está documentada internamente y debe cambiarse en producción. El panel web marca con un banner rojo cualquier dispositivo que aún use la contraseña de fábrica.
WiFi
El agente Android no gestiona la configuración WiFi internamente — usa la configuración del sistema Android. Para añadir o cambiar WiFi:
- Conecta un teclado/ratón al dispositivo y entra en los ajustes de Android.
- O bien, si compraste el dispositivo a Promotienda y especificaste SSID + contraseña en el formulario de compra, viene preconfigurado y conecta solo en el primer arranque.
Reset / borrado
Si necesitas desvincular el dispositivo del panel:
- En el panel, Acciones → Eliminar sobre la fila — libera la plaza.
- En el dispositivo, abre Ajustes (Admin) → borra ID del dispositivo y URL del servidor. O desinstala la app desde Android.
Bloqueo de quiosco (modo pantalla fija)
Impide salir de la aplicación: sin barra de estado, sin desplegable de notificaciones, sin recientes y sin menú de apagado. Hay dos mecanismos y el agente usa el mejor disponible en cada equipo.
En el menú Admin (2016), justo bajo el botón de bloqueo, el agente indica qué método usará este equipo concreto, para no depender de suposiciones:
| Lo que muestra | Qué significa |
|---|---|
| Método de bloqueo: LockTask (propietario del dispositivo) — activo | Bloqueo real en marcha. |
| Método de bloqueo: LockTask (propietario del dispositivo) — disponible | Aprovisionado correctamente; se activará al encender el bloqueo. |
| Método de bloqueo: root (desactivar SystemUI) | Sólo equipos con root. Funciona en Android 5.1; en Android 10+ el sistema restaura la interfaz a los pocos segundos. |
| Sin método de bloqueo disponible en este dispositivo | Ni propietario del dispositivo ni root: el botón no tendrá efecto real. |
Aprovisionar como propietario del dispositivo
Es la opción recomendada y no requiere root. Se hace una sola vez, durante la instalación, y el equipo no debe tener ninguna cuenta de Google añadida (si la tiene, hay que quitarla o restablecer de fábrica primero).
adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver
Respuesta esperada: Success: Device owner set to package ....
Después, activa Bloqueo completo de quiosco en el menú Admin. El agente vuelve a entrar en bloqueo solo tras cada reinicio, cambio de modo o actualización.
Para quitar el bloqueo, desactívalo desde el menú Admin antes de retirar el equipo. Un dispositivo que sigue siendo propietario y bloqueado sólo se recupera por ADB o con un restablecimiento de fábrica.
Requisitos
- Agente 2.4.0 o superior.
- Android 5.1 o superior (probado de Android 5.1 a Android 15).
- Sin cuentas en el dispositivo en el momento de aprovisionar.