Agente Android — Configurazione
Le impostazioni sono protette da password. Per aprirle: tocchi 4 volte sullo sfondo e scelga il livello Admin o Utente.
Impostazioni gestite dal pannello web
Questi valori si gestiscono in Pannello → Dispositivi → Modifica kiosk, non sul dispositivo. L'agente li riceve all'heartbeat successivo:
- Modalità Web Kiosk o Playlist
- URL iniziale (modalità Web Kiosk)
- Whitelist di URL (modalità Web Kiosk)
- Playlist assegnata (modalità Playlist)
- Password del menu admin
Impostazioni gestite sul dispositivo
Queste si possono modificare solo dalle impostazioni locali dell'agente (livello Admin):
| Impostazione | Descrizione |
|---|---|
| URL del server | Endpoint base RDS. Per impostazione predefinita https://rds.digitalsignagerds.com. |
| ID del dispositivo | Codice RDSXXXX assegnato nel pannello. Senza di esso l'agente non può autenticarsi. |
| Intervallo di sync | Tempo tra un heartbeat e l'altro / tra i controlli di nuovi contenuti. |
| Percorso di archiviazione | Dove salvare la cache locale di video e immagini (di norma la memoria esterna). |
| Modalità di visualizzazione | Schermo intero con stretch o letterbox, a seconda dell'aspect ratio del video. |
| Volume | Slider del volume del player. |
Password admin
Due livelli:
- Admin (
contrassenya_settings) — controllo totale. - Utente (
contraUser_settings) — sola consultazione delle informazioni.
La password predefinita di fabbrica è documentata internamente e deve essere cambiata in produzione. Il pannello web segnala con un banner rosso ogni dispositivo che usa ancora la password di fabbrica.
WiFi
L'agente Android non gestisce internamente la configurazione WiFi — usa quella del sistema Android. Per aggiungere o cambiare una rete WiFi:
- Colleghi una tastiera/un mouse al dispositivo ed entri nelle impostazioni di Android.
- Oppure, se ha acquistato il dispositivo da Promotienda e ha indicato SSID + password nel modulo d'acquisto, arriva preconfigurato e si connette da solo al primo avvio.
Reset / rimozione
Se ha bisogno di scollegare il dispositivo dal pannello:
- Nel pannello, Azioni → Elimina sulla riga — libera la postazione.
- Sul dispositivo, apra le Impostazioni (Admin) → cancelli ID del dispositivo e URL del server. Oppure disinstalli l'app da Android.
Blocco kiosk (modalità schermo fisso)
Impedisce di uscire dall'applicazione: niente barra di stato, niente tendina delle notifiche, niente app recenti e niente menu di spegnimento. Esistono due meccanismi e l'agente usa il migliore disponibile su ciascun apparecchio.
Nel menu Admin (2016), subito sotto il pulsante di blocco, l'agente indica quale metodo userà questo specifico apparecchio, per non basarsi su supposizioni:
| Cosa mostra | Cosa significa |
|---|---|
| Metodo di blocco: LockTask (proprietario del dispositivo) — attivo | Blocco reale in funzione. |
| Metodo di blocco: LockTask (proprietario del dispositivo) — disponibile | Provisioning corretto; si attiverà all'accensione del blocco. |
| Metodo di blocco: root (disattivazione di SystemUI) | Solo apparecchi con root. Funziona su Android 5.1; su Android 10+ il sistema ripristina l'interfaccia dopo pochi secondi. |
| Nessun metodo di blocco disponibile su questo dispositivo | Né proprietario del dispositivo né root: il pulsante non avrà alcun effetto reale. |
Effettuare il provisioning come proprietario del dispositivo
È l'opzione consigliata e non richiede root. Si esegue una sola volta, durante l'installazione, e l'apparecchio non deve avere alcun account Google configurato (se ce l'ha, occorre prima rimuoverlo o eseguire un ripristino di fabbrica).
adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver
Risposta attesa: Success: Device owner set to package ....
Successivamente attivi Blocco completo del kiosk nel menu Admin. L'agente rientra in blocco da solo dopo ogni riavvio, cambio di modalità o aggiornamento.
Per togliere il blocco, lo disattivi dal menu Admin prima di ritirare l'apparecchio. Un dispositivo che resta proprietario e bloccato si recupera solo via ADB o con un ripristino di fabbrica.
Requisiti
- Agente 2.4.0 o superiore.
- Android 5.1 o superiore (testato da Android 5.1 ad Android 15).
- Nessun account sul dispositivo al momento del provisioning.