Agent Android — Configuració
Els ajustos estan protegits per contrasenya. Per obrir-los: toca 4 vegades sobre el fons i tria nivell Admin o Usuari.
Ajustos que es gestionen des del panell web
Aquests valors els gestiones a Panell → Dispositius → Editar kiosk, no al dispositiu. L'agent els rep en el seu pròxim heartbeat:
- Mode Web Kiosk vs Playlist
- URL d'inici (mode Web Kiosk)
- Whitelist d'URLs (mode Web Kiosk)
- Playlist assignada (mode Playlist)
- Contrasenya del menú admin
Ajustos que es gestionen al dispositiu
Aquests només es poden tocar des dels ajustos locals de l'agent (nivell Admin):
| Ajust | Descripció |
|---|---|
| URL del servidor | Endpoint base RDS. Per defecte https://rds.digitalsignagerds.com. |
| ID del dispositiu | Codi RDSXXXX assignat al panell. Sense això l'agent no es pot autenticar. |
| Interval de sync | Temps entre heartbeats / comprovacions de contingut nou. |
| Ruta d'emmagatzematge | On desar la caché local de vídeos i imatges (típicament emmagatzematge extern). |
| Mode de visualització | Pantalla completa amb stretch o letterbox segons l'aspect ratio del vídeo. |
| Volum | Slider de volum del player. |
Contrasenya admin
Dos nivells:
- Admin (
contrassenya_settings) — control total. - Usuari (
contraUser_settings) — només veure informació.
La contrasenya per defecte de fàbrica està documentada internament i s'ha de canviar en producció. El panell web marca amb un banner vermell qualsevol dispositiu que encara faci servir la contrasenya de fàbrica.
WiFi
L'agent Android no gestiona la configuració WiFi internament — fa servir la configuració del sistema Android. Per afegir o canviar WiFi:
- Connecta un teclat/ratolí al dispositiu i entra als ajustos d'Android.
- O bé, si has comprat el dispositiu a Promotienda i has especificat SSID + contrasenya al formulari de compra, ve preconfigurat i connecta sol en el primer arrencament.
Reset / esborrat
Si necessites desvincular el dispositiu del panell:
- Al panell, Accions → Eliminar sobre la fila — allibera la plaça.
- Al dispositiu, obre Ajustos (Admin) → esborra ID del dispositiu i URL del servidor. O desinstal·la l'app des d'Android.
Bloqueig de quiosc (mode pantalla fixada)
Impedeix sortir de l'aplicació: sense barra d'estat, sense desplegable de notificacions, sense recents i sense menú d'apagada. Hi ha dos mecanismes i l'agent fa servir el millor disponible a cada equip.
Al menú Admin (2016), just sota el botó de bloqueig, l'agent indica quin mètode farà servir aquest equip concret, per no dependre de suposicions:
| Què mostra | Què vol dir |
|---|---|
| Mètode de bloqueig: LockTask (propietari del dispositiu) — actiu | Bloqueig real en marxa. |
| Mètode de bloqueig: LockTask (propietari del dispositiu) — disponible | Aprovisionat correctament; s'activarà en encendre el bloqueig. |
| Mètode de bloqueig: root (desactivar SystemUI) | Només equips amb root. Funciona a Android 5.1; a Android 10+ el sistema restaura la interfície al cap de pocs segons. |
| Sense mètode de bloqueig disponible en aquest dispositiu | Ni propietari del dispositiu ni root: el botó no tindrà cap efecte real. |
Aprovisionar com a propietari del dispositiu
És l'opció recomanada i no requereix root. Es fa una sola vegada, durant la instal·lació, i l'equip no ha de tenir cap compte de Google afegit (si en té, cal treure'l o restablir de fàbrica primer).
adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver
Resposta esperada: Success: Device owner set to package ....
Després, activa Bloqueig complet de quiosc al menú Admin. L'agent torna a entrar en bloqueig tot sol després de cada reinici, canvi de mode o actualització.
Per treure el bloqueig, desactiva'l des del menú Admin abans de retirar l'equip. Un dispositiu que continua sent propietari i bloquejat només es recupera per ADB o amb un restabliment de fàbrica.
Requisits
- Agent 2.4.0 o superior.
- Android 5.1 o superior (provat d'Android 5.1 a Android 15).
- Sense comptes al dispositiu en el moment d'aprovisionar.