Agente Android — Installazione

Requisiti

• Android 5.0 (API 21) o superiore. Verificato fino ad Android 15.
• Schermo in orientamento orizzontale (l'agente forza il landscape).
• ~200 MB liberi nella memoria esterna per la cache dei contenuti (di più, a seconda del peso della sua playlist).
• Connessione a internet — Ethernet o WiFi.

Installare l'APK

L'APK si chiama promotienda.rds.apk e viene fornito da Promotienda.

1. Abiliti sul dispositivo Impostazioni → Sicurezza → Origini sconosciute (o l'equivalente della sua versione di Android: consentire l'installazione di APK dalla fonte che intende usare).
2. Scarichi l'APK dal link fornito da Promotienda.
3. Lo apra dal gestore file per avviare l'installazione.
4. Conceda i permessi richiesti al primo avvio:
   • Memoria — per salvare i video e le immagini scaricati.
   • Posizione — l'agente invia le coordinate GPS al server (solo se disponibili).
   • Visualizzazione sopra altre app — per le finestre di dialogo delle impostazioni.

Su Android 6+ alcuni permessi vengono richiesti solo quando servono per la prima volta.

Primo avvio

Alla prima apertura, l'app tenta di autenticarsi sul server con la configurazione predefinita e mostra uno sfondo neutro finché non le viene assegnata una playlist.

Per configurare il dispositivo:

1. Tocchi 4 volte un punto qualsiasi dello sfondo in meno di 3 secondi.
2. Compare una finestra di password. Esistono due livelli:
   • Admin — accesso completo alle impostazioni (URL del server, intervalli di sync, percorso di archiviazione).
   • Utente — sola lettura: informazioni sul dispositivo e configurazione di base.
3. Dopo aver inserito la password ha 30 secondi prima che le impostazioni si chiudano per inattività.

Anche il tasto Indietro del dispositivo apre la richiesta di password.

Avvio automatico

L'APK registra un receiver BOOT_COMPLETED — quando il dispositivo si riavvia (per un'interruzione di corrente, un riavvio programmato, ecc.) l'agente si avvia automaticamente senza interventi.

Abilitarlo come app Home (necessario su Android 10+)

Da Android 10 (API 29) le app non possono avviare Activity da un broadcast receiver o da un servizio in background. Il receiver BOOT_COMPLETED avvia il servizio, ma l'Activity del kiosk resta bloccata e dopo il riavvio il dispositivo rimane sul launcher.

La soluzione standard per un kiosk è dichiarare l'APK come app Home del dispositivo. Serve una sola volta per dispositivo.

Procedura guidata automatica (dalla v2.1): alla prima apertura dell'app su un dispositivo in cui non è ancora l'app Home, compare una finestra di dialogo:

Imposta come app di avvio Perché il kiosk si avvii automaticamente a ogni accensione del dispositivo, lo imposti come applicazione Home. [ Più tardi ] [ Configura ]

Prema Configura e le impostazioni di Android si apriranno direttamente sulla schermata Default home app. Scelga "Digital Signage RDS" e confermi.

Procedura manuale (se ha premuto Più tardi o la finestra non è comparsa):

1. Settings → Apps → Default apps → Home app (su alcuni OEM: Settings → Apps → "App di avvio" oppure Settings → Home)
2. Scegliere "Digital Signage RDS" dall'elenco
3. Accettare la conferma

Da quel momento Android avvia il kiosk direttamente all'accensione (senza passare dal launcher). Anche il tasto HOME riporta sempre al kiosk — utile per impedire all'utente di uscire.

La finestra automatica ricompare a ogni avvio finché il kiosk non è impostato come app Home. Se la chiude con Più tardi, riappare alla successiva apertura dell'app o al riavvio del dispositivo.

Abilitare il servizio di accessibilità (screenshot a schermo intero)

Subito dopo la finestra dell'app Home, se il dispositivo è Android 11+ e il servizio di accessibilità per gli screenshot non è abilitato, compare una seconda finestra:

Attiva gli screenshot remoti Per consentire al pannello RDS di richiedere screenshot in qualsiasi momento (anche se l'app non è in primo piano), attivi il servizio di accessibilità di "Digital Signage RDS". [ Più tardi ] [ Attiva ]

Prema Attiva → si aprono le impostazioni di accessibilità → Servizi scaricati → Digital Signage RDS → Attiva. Confermi l'avviso di sistema sui permessi.

Senza questo servizio:

• Gli screenshot vengono eseguiti solo mentre un'Activity del kiosk è in primo piano.
• Se il kiosk è andato in crash o mostra una finestra di sistema, il pannello riceverà un'immagine dell'ultimo frame visibile — non la schermata attuale.

Con il servizio attivo, gli screenshot funzionano sempre, includono la system UI, le finestre di errore e la lockscreen, e sopravvivono ai crash dell'Activity (Android ricrea automaticamente il binding di accessibilità).

Come per la finestra dell'app Home: se la chiude con Più tardi, ricompare a ogni avvio finché il servizio non è abilitato.

Verificare l'avvio automatico

Dopo un riavvio, i log dell'agente registrano:

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

Se vede la riga BroadcastReceived ma il kiosk non compare, quasi certamente manca il passaggio dell'app Home. Consulti i log nel pannello: Azioni → Logs.

Versione installata

La versione dell'agente è visibile in Impostazioni → versione. Viene inoltre comunicata al server a ogni heartbeat e mostrata nella colonna versione dell'elenco dei dispositivi.

Versione minima supportata per Android: 2.0.0. Le versioni inferiori mostrano un banner End of Life nel pannello.