Agente Android — Instalación

Requisitos

• Android 5.0 (API 21) o superior. Verificado hasta Android 15.
• Pantalla en orientación horizontal (el agente fuerza landscape).
• ~200 MB libres en almacenamiento externo para caché de contenido (más, según el peso de tu playlist).
• Conexión a internet — Ethernet o WiFi.

Instalar el APK

El APK se llama promotienda.rds.apk y lo proporciona Promotienda.

1. Habilita en el dispositivo Ajustes → Seguridad → Orígenes desconocidos (o el equivalente de tu versión de Android: permitir instalar APKs desde la fuente que vas a usar).
2. Descarga el APK desde el enlace que te haya facilitado Promotienda.
3. Ábrelo desde el gestor de archivos para iniciar la instalación.
4. Concede los permisos solicitados al primer arranque:
   • Almacenamiento — para guardar vídeos e imágenes descargados.
   • Ubicación — el agente envía coordenadas GPS al servidor (sólo si están disponibles).
   • Mostrar sobre otras apps — para los diálogos de ajustes.

En Android 6+ algunos permisos sólo se piden cuando se necesitan por primera vez.

Primer arranque

Al abrir la app por primera vez intenta autenticarse contra el servidor con la configuración por defecto y muestra un fondo neutro hasta que tenga una playlist asignada.

Para configurar el dispositivo:

1. Toca 4 veces sobre cualquier punto del fondo en menos de 3 segundos.
2. Aparece un diálogo de contraseña. Hay dos niveles:
   • Admin — acceso completo a ajustes (URL del servidor, intervalos de sync, ruta de almacenamiento).
   • Usuario — sólo lectura: información del dispositivo y config básica.
3. Tras introducir la contraseña tienes 30 segundos antes de que se cierren los ajustes por inactividad.

El botón Atrás del dispositivo también abre el prompt de contraseña.

Auto-arranque

El APK registra un BOOT_COMPLETED receiver — cuando el dispositivo se reinicie (por corte de luz, reinicio programado, etc.) el agente arrancará automáticamente sin intervención.

Habilitar como app Home (necesario en Android 10+)

Desde Android 10 (API 29) las apps no pueden lanzar Activities desde un broadcast receiver / servicio en segundo plano. El receiver BOOT_COMPLETED arranca el servicio, pero la Activity del kiosk se queda bloqueada y el dispositivo se queda en el launcher tras reiniciar.

La solución estándar para un kiosk es declarar el APK como app Home del dispositivo. Sólo hace falta una vez por dispositivo.

Asistente automático (desde v2.1): al abrir la app por primera vez en un dispositivo donde aún no es la app Home, aparece un diálogo:

Configurar como app de inicio Para que el kiosk se inicie automáticamente cada vez que se enciende el dispositivo, configúralo como aplicación Home. [ Más tarde ] [ Configurar ]

Pulsa Configurar y se abrirán los ajustes de Android directamente en la pantalla Default home app. Elige "Digital Signage RDS" y confirma.

Asistente manual (si pulsaste Más tarde o el diálogo no apareció):

1. Settings → Apps → Default apps → Home app (en algunos OEMs: Settings → Apps → "App de inicio" o Settings → Home)
2. Elegir "Digital Signage RDS" de la lista
3. Aceptar la confirmación

Desde ese momento, Android lanza el kiosk directamente al arranque (sin pasar por launcher). El botón HOME también devuelve siempre al kiosk — útil para evitar que el usuario salga.

El diálogo automático se vuelve a mostrar en cada inicio mientras el kiosk no esté como app Home. Si lo descartas con Más tarde, vuelve a aparecer la próxima vez que se abra la app o el dispositivo se reinicie.

Habilitar el servicio de accesibilidad (capturas full-screen)

Justo después del diálogo de Home, si el dispositivo es Android 11+ y el servicio de accesibilidad de capturas no está habilitado, aparece un segundo diálogo:

Activar capturas remotas Para permitir al panel RDS solicitar capturas de pantalla en cualquier momento (incluso si la app no está en primer plano), activa el servicio de accesibilidad de "Digital Signage RDS". [ Más tarde ] [ Activar ]

Pulsa Activar → se abren los ajustes de accesibilidad → Servicios descargados → Digital Signage RDS → Activar. Confirma el aviso del sistema sobre los permisos.

Sin este servicio:

• Las capturas se hacen sólo mientras una Activity del kiosk está en primer plano.
• Si el kiosk ha caído o muestra un diálogo del sistema, el panel recibirá una imagen del último frame visible — no la pantalla actual.

Con el servicio activado, las capturas funcionan siempre, incluyen system UI / diálogos de error / lockscreen, y sobreviven a caídas de la Activity (Android relanza automáticamente el binding de accesibilidad).

Como con el diálogo de Home: si lo descartas con Más tarde, reaparece en cada inicio hasta que el servicio esté habilitado.

Verificar el auto-arranque

Tras un reinicio, los logs del agente registran:

[BOOT      ] BroadcastReceived: android.intent.action.BOOT_COMPLETED
[BOOT      ] MainActivity launch requested
[BOOT      ] AutoStartUp service start requested
[SYSTEM    ] Digital Signage RDS …

Si ves la línea de BroadcastReceived pero el kiosk no aparece, casi seguro falta el paso de app Home. Ver los logs en el panel: Acciones → Logs.

Versión instalada

La versión del agente la verás en Ajustes → versión. También se reporta al servidor en cada heartbeat y se muestra en la columna versión del listado de dispositivos.

Versión mínima soportada para Android: 2.0.0. Versiones inferiores muestran un banner End of Life en el panel.