Android agent — Configuration

Settings are password-protected. To open them: tap 4 times on the background and pick Admin or User level.

Settings managed from the web panel

These values are managed in Panel → Devices → Edit kiosk, not on the device. The agent receives them on its next heartbeat:

Web Kiosk vs Playlist mode
Home URL (Web Kiosk mode)
URL whitelist (Web Kiosk mode)
Assigned playlist (Playlist mode)
Admin-menu password

Settings managed on the device

These can only be changed from the local agent settings (Admin level):

Setting	Description
Server URL	RDS base endpoint. Default `https://rds.digitalsignagerds.com`.
Device ID	`RDSXXXX` code assigned in the panel. Without this the agent can't authenticate.
Sync interval	Time between heartbeats / new-content checks.
Storage path	Where to keep the local cache of videos and images (typically external storage).
Display mode	Fullscreen with stretch or letterbox depending on video aspect ratio.
Volume	Player volume slider.

Admin password

Two levels:

Admin (contrassenya_settings) — full control.
User (contraUser_settings) — info only.

The factory default password is documented internally and must be changed in production. The web panel flags with a red banner any device still using the factory password.

WiFi

The Android agent does not manage WiFi configuration itself — it uses Android's system settings. To add or change WiFi:

Plug in a keyboard/mouse and go into Android settings.
Or, if you bought the device from Promotienda and specified SSID + password in the purchase form, it ships preconfigured and connects on first boot.

Reset / unlink

If you need to unlink the device from the panel:

In the panel, Actions → Delete on the row — frees the slot.
On the device, open Admin Settings → clear Device ID and Server URL. Or uninstall the app from Android.

Kiosk lockdown (locked-screen mode)

Prevents anyone leaving the app: no status bar, no notification shade, no recents and no power menu. There are two mechanisms and the agent uses the best one available on each device.

In the Admin menu (2016), just below the lockdown button, the agent states which method this particular device will use, so it is not a guess:

What it shows	What it means
Lockdown method: LockTask (device owner) — active	Real lockdown in force.
Lockdown method: LockTask (device owner) — available	Provisioned correctly; engages when you turn lockdown on.
Lockdown method: root (SystemUI disable)	Rooted devices only. Works on Android 5.1; on Android 10+ the system restores the interface within seconds.
No lockdown method available on this device	Neither device owner nor root: the button will have no real effect.

Provisioning as device owner

This is the recommended option and does not require root. It is done once, during installation, and the device must have no Google account added (remove it or factory reset first if it does).

adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver

Expected reply: Success: Device owner set to package ....

Then enable Full kiosk lockdown in the Admin menu. The agent re-enters lockdown by itself after every reboot, mode change or update.

To remove the lockdown, turn it off from the Admin menu before retiring the device. A device left as owner and locked can only be recovered over ADB or with a factory reset.

Requirements

Agent 2.4.0 or newer.
Android 5.1 or newer (tested from Android 5.1 to Android 15).
No accounts on the device at provisioning time.