Android-Agent — Konfiguration
Die Einstellungen sind durch ein Passwort geschützt. Zum Öffnen: 4-mal auf den Hintergrund tippen und die Stufe Admin oder Benutzer wählen.
Einstellungen, die über das Web-Panel verwaltet werden
Diese Werte verwalten Sie unter Panel → Geräte → Kiosk bearbeiten, nicht auf dem Gerät. Der Agent erhält sie mit seinem nächsten Heartbeat:
- Modus Web Kiosk oder Playlist
- Start-URL (Modus Web Kiosk)
- URL-Whitelist (Modus Web Kiosk)
- Zugewiesene Playlist (Modus Playlist)
- Passwort des Admin-Menüs
Einstellungen, die auf dem Gerät verwaltet werden
Diese lassen sich nur über die lokalen Einstellungen des Agenten ändern (Stufe Admin):
| Einstellung | Beschreibung |
|---|---|
| Server-URL | RDS-Basis-Endpoint. Standard: https://rds.digitalsignagerds.com. |
| Geräte-ID | Im Panel vergebener Code RDSXXXX. Ohne ihn kann sich der Agent nicht authentifizieren. |
| Sync-Intervall | Zeit zwischen Heartbeats / Prüfungen auf neue Inhalte. |
| Speicherpfad | Wo der lokale Cache für Videos und Bilder abgelegt wird (in der Regel externer Speicher). |
| Anzeigemodus | Vollbild mit Stretch oder Letterbox, je nach Seitenverhältnis des Videos. |
| Lautstärke | Lautstärkeregler des Players. |
Admin-Passwort
Zwei Stufen:
- Admin (
contrassenya_settings) — volle Kontrolle. - Benutzer (
contraUser_settings) — nur Informationen einsehen.
Das werkseitige Standardpasswort ist intern dokumentiert und muss im Produktivbetrieb geändert werden. Das Web-Panel markiert jedes Gerät, das noch das Werkspasswort verwendet, mit einem roten Banner.
WLAN
Der Android-Agent verwaltet die WLAN-Konfiguration nicht selbst — er nutzt die Konfiguration des Android-Systems. So fügen Sie ein WLAN hinzu oder ändern es:
- Schließen Sie Tastatur/Maus an das Gerät an und öffnen Sie die Android-Einstellungen.
- Oder: Wenn Sie das Gerät bei Promotienda gekauft und im Bestellformular SSID + Passwort angegeben haben, ist es vorkonfiguriert und verbindet sich beim ersten Start von selbst.
Zurücksetzen / Löschen
Wenn Sie das Gerät vom Panel trennen möchten:
- Im Panel Aktionen → Löschen in der Zeile — das gibt den Platz frei.
- Auf dem Gerät die Einstellungen (Admin) öffnen → Geräte-ID und Server-URL löschen. Oder die App unter Android deinstallieren.
Kiosk-Sperre (Modus Bildschirmfixierung)
Verhindert das Verlassen der Anwendung: keine Statusleiste, kein Benachrichtigungs-Dropdown, keine zuletzt verwendeten Apps und kein Ausschaltmenü. Es gibt zwei Mechanismen und der Agent nutzt den jeweils besten verfügbaren.
Im Admin-Menü (2016) zeigt der Agent direkt unter der Sperr-Schaltfläche an, welche Methode genau dieses Gerät verwenden wird, damit Sie nicht auf Vermutungen angewiesen sind:
| Anzeige | Bedeutung |
|---|---|
| Sperrmethode: LockTask (Geräteeigentümer) — aktiv | Echte Sperre ist in Kraft. |
| Sperrmethode: LockTask (Geräteeigentümer) — verfügbar | Korrekt bereitgestellt; wird beim Einschalten der Sperre aktiv. |
| Sperrmethode: root (SystemUI deaktivieren) | Nur Geräte mit Root. Funktioniert unter Android 5.1; unter Android 10+ stellt das System die Oberfläche nach wenigen Sekunden wieder her. |
| Keine Sperrmethode auf diesem Gerät verfügbar | Weder Geräteeigentümer noch Root: die Schaltfläche hat keine echte Wirkung. |
Als Geräteeigentümer bereitstellen
Das ist die empfohlene Option und erfordert kein Root. Sie erfolgt einmalig während der Installation, und auf dem Gerät darf kein Google-Konto hinterlegt sein (falls doch, muss es entfernt oder das Gerät zuvor auf Werkseinstellungen zurückgesetzt werden).
adb shell dpm set-device-owner com.digitalsignage.rds/promotienda.rds.RdsDeviceAdminReceiver
Erwartete Antwort: Success: Device owner set to package ....
Aktivieren Sie anschließend Vollständige Kiosk-Sperre im Admin-Menü. Der Agent geht nach jedem Neustart, Moduswechsel oder Update selbstständig wieder in die Sperre.
Um die Sperre zu entfernen, deaktivieren Sie sie im Admin-Menü, bevor Sie das Gerät außer Betrieb nehmen. Ein Gerät, das Eigentümer bleibt und gesperrt ist, lässt sich nur über ADB oder mit einem Werksreset wiederherstellen.
Voraussetzungen
- Agent 2.4.0 oder höher.
- Android 5.1 oder höher (getestet von Android 5.1 bis Android 15).
- Keine Konten auf dem Gerät zum Zeitpunkt der Bereitstellung.