Agent Android — Instal·lació

Requisits

• Android 5.0 (API 21) o superior. Verificat fins a Android 15.
• Pantalla en orientació horitzontal (l'agent força landscape).
• ~200 MB lliures a l'emmagatzematge extern per a la caché de contingut (més, segons el pes de la teva playlist).
• Connexió a internet — Ethernet o WiFi.

Instal·lar l'APK

L'APK es diu promotienda.rds.apk i el proporciona Promotienda.

1. Habilita al dispositiu Ajustaments → Seguretat → Orígens desconeguts (o l'equivalent de la teva versió d'Android: permetre instal·lar APKs des de la font que faràs servir).
2. Descarrega l'APK des de l'enllaç que t'hagi facilitat Promotienda.
3. Obre'l des del gestor d'arxius per iniciar la instal·lació.
4. Concedeix els permisos sol·licitats al primer arrencada:
   • Emmagatzematge — per desar vídeos i imatges descarregats.
   • Ubicació — l'agent envia coordenades GPS al servidor (només si estan disponibles).
   • Mostrar sobre altres apps — per als diàlegs d'ajustaments.

A Android 6+ alguns permisos només es demanen quan es necessiten per primera vegada.

Primer arrencada

En obrir l'app per primera vegada intenta autenticar-se contra el servidor amb la configuració per defecte i mostra un fons neutre fins que tingui una playlist assignada.

Per configurar el dispositiu:

1. Toca 4 vegades sobre qualsevol punt del fons en menys de 3 segons.
2. Apareix un diàleg de contrasenya. Hi ha dos nivells:
   • Admin — accés complet a ajustaments (URL del servidor, intervals de sync, ruta d'emmagatzematge).
   • Usuari — només lectura: informació del dispositiu i config bàsica.
3. Després d'introduir la contrasenya tens 30 segons abans que els ajustaments es tanquin per inactivitat.

El botó Enrere del dispositiu també obre el prompt de contrasenya.

Auto-arrencada

L'APK registra un BOOT_COMPLETED receiver — quan el dispositiu es reiniciï (per tall de llum, reinici programat, etc.) l'agent arrencarà automàticament sense intervenció.

Habilitar com a app Home (necessari a Android 10+)

Des d'Android 10 (API 29) les apps no poden llançar Activities des d'un broadcast receiver / servei en segon pla. El receiver BOOT_COMPLETED arrenca el servei, però l'Activity del kiosk es queda bloquejada i el dispositiu es queda al launcher després de reiniciar.

La solució estàndard per a un kiosk és declarar l'APK com a app Home del dispositiu. Només cal una vegada per dispositiu.

Assistent automàtic (des de v2.1): en obrir l'app per primera vegada en un dispositiu on encara no és l'app Home, apareix un diàleg:

Configurar com a app d'inici Perquè el kiosk s'iniciï automàticament cada vegada que s'engega el dispositiu, configura'l com a aplicació Home. [ Més tard ] [ Configurar ]

Prem Configurar i s'obriran els ajustaments d'Android directament a la pantalla Default home app. Tria "Digital Signage RDS" i confirma.

Assistent manual (si vas prémer Més tard o el diàleg no va aparèixer):

1. Settings → Apps → Default apps → Home app (en alguns OEMs: Settings → Apps → "App d'inici" o Settings → Home)
2. Triar "Digital Signage RDS" de la llista
3. Acceptar la confirmació

Des d'aquell moment, Android llança el kiosk directament a l'arrencada (sense passar pel launcher). El botó HOME també torna sempre al kiosk — útil per evitar que l'usuari surti.

El diàleg automàtic torna a aparèixer a cada inici mentre el kiosk no estigui com a app Home. Si el descartes amb Més tard, torna a aparèixer la propera vegada que s'obri l'app o el dispositiu es reiniciï.

Habilitar el servei d'accessibilitat (captures full-screen)

Just després del diàleg de Home, si el dispositiu és Android 11+ i el servei d'accessibilitat de captures no està habilitat, apareix un segon diàleg:

Activar captures remotes Per permetre al panell RDS sol·licitar captures de pantalla en qualsevol moment (fins i tot si l'app no està en primer pla), activa el servei d'accessibilitat de "Digital Signage RDS". [ Més tard ] [ Activar ]

Prem Activar → s'obren els ajustaments d'accessibilitat → Serveis descarregats → Digital Signage RDS → Activar. Confirma l'avís del sistema sobre els permisos.

Sense aquest servei:

• Les captures es fan només mentre una Activity del kiosk està en primer pla.
• Si el kiosk ha caigut o mostra un diàleg del sistema, el panell rebrà una imatge de l'últim frame visible — no la pantalla actual.

Amb el servei activat, les captures funcionen sempre, inclouen system UI / diàlegs d'error / lockscreen, i sobreviuen a caigudes de l'Activity (Android relança automàticament el binding d'accessibilitat).

Com amb el diàleg de Home: si el descartes amb Més tard, reapareix a cada inici fins que el servei estigui habilitat.

Verificar l'auto-arrencada

Després d'un reinici, els logs de l'agent registren:

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

Si veus la línia de BroadcastReceived però el kiosk no apareix, gairebé segur falta el pas d'app Home. Veure els logs al panell: Accions → Logs.

Versió instal·lada

La versió de l'agent la veuràs a Ajustaments → versió. També es reporta al servidor a cada heartbeat i es mostra a la columna versió del llistat de dispositius.

Versió mínima suportada per Android: 2.0.0. Versions inferiors mostren un banner End of Life al panell.