Android-Agent — Installation

Voraussetzungen

• Android 5.0 (API 21) oder höher. Getestet bis Android 15.
• Bildschirm im Querformat (der Agent erzwingt Landscape).
• ~200 MB freier externer Speicher für den Inhalts-Cache (mehr, je nach Umfang Ihrer Playlist).
• Internetverbindung — Ethernet oder WLAN.

APK installieren

Das APK heißt promotienda.rds.apk und wird von Promotienda bereitgestellt.

1. Aktivieren Sie auf dem Gerät Einstellungen → Sicherheit → Unbekannte Quellen (oder das Äquivalent Ihrer Android-Version: Installation von APKs aus der genutzten Quelle erlauben).
2. Laden Sie das APK über den Link herunter, den Ihnen Promotienda zur Verfügung gestellt hat.
3. Öffnen Sie es im Dateimanager, um die Installation zu starten.
4. Erteilen Sie die beim ersten Start angeforderten Berechtigungen:
   • Speicher — zum Ablegen heruntergeladener Videos und Bilder.
   • Standort — der Agent sendet GPS-Koordinaten an den Server (nur sofern verfügbar).
   • Über anderen Apps einblenden — für die Einstellungsdialoge.

Unter Android 6+ werden manche Berechtigungen erst abgefragt, wenn sie zum ersten Mal benötigt werden.

Erster Start

Beim ersten Öffnen versucht die App, sich mit der Standardkonfiguration am Server zu authentifizieren, und zeigt einen neutralen Hintergrund an, bis ihr eine Playlist zugewiesen ist.

So konfigurieren Sie das Gerät:

1. Tippen Sie 4-mal innerhalb von 3 Sekunden auf eine beliebige Stelle des Hintergrunds.
2. Es erscheint ein Passwort-Dialog. Es gibt zwei Stufen:
   • Admin — voller Zugriff auf die Einstellungen (Server-URL, Sync-Intervalle, Speicherpfad).
   • Benutzer — nur lesend: Geräteinformationen und Basiskonfiguration.
3. Nach Eingabe des Passworts haben Sie 30 Sekunden, bevor sich die Einstellungen wegen Inaktivität schließen.

Auch die Zurück-Taste des Geräts öffnet die Passwortabfrage.

Autostart

Das APK registriert einen BOOT_COMPLETED-Receiver — wenn das Gerät neu startet (Stromausfall, geplanter Neustart usw.), startet der Agent ohne Zutun automatisch.

Als Home-App einrichten (unter Android 10+ erforderlich)

Seit Android 10 (API 29) dürfen Apps keine Activities aus einem Broadcast-Receiver / Hintergrunddienst heraus starten. Der BOOT_COMPLETED-Receiver startet zwar den Dienst, doch die Activity des Kiosks wird blockiert und das Gerät bleibt nach dem Neustart im Launcher stehen.

Die Standardlösung für einen Kiosk ist, das APK als Home-App des Geräts festzulegen. Das ist nur einmal pro Gerät nötig.

Automatischer Assistent (ab v2.1): Beim ersten Öffnen der App auf einem Gerät, auf dem sie noch nicht die Home-App ist, erscheint ein Dialog:

Als Start-App festlegen Damit der Kiosk bei jedem Einschalten des Geräts automatisch startet, legen Sie ihn als Home-Anwendung fest. [ Später ] [ Konfigurieren ]

Drücken Sie Konfigurieren und die Android-Einstellungen öffnen sich direkt auf dem Bildschirm Default home app. Wählen Sie "Digital Signage RDS" und bestätigen Sie.

Manueller Weg (falls Sie Später gedrückt haben oder der Dialog nicht erschienen ist):

1. Settings → Apps → Default apps → Home app (bei manchen OEMs: Settings → Apps → "Start-App" oder Settings → Home)
2. "Digital Signage RDS" aus der Liste wählen
3. Die Bestätigung akzeptieren

Ab diesem Zeitpunkt startet Android den Kiosk direkt beim Hochfahren (ohne Umweg über den Launcher). Auch die HOME-Taste führt immer zum Kiosk zurück — nützlich, damit der Benutzer ihn nicht verlässt.

Der automatische Dialog erscheint bei jedem Start erneut, solange der Kiosk nicht als Home-App eingerichtet ist. Wenn Sie ihn mit Später schließen, taucht er beim nächsten Öffnen der App oder beim nächsten Neustart des Geräts wieder auf.

Bedienungshilfen-Dienst aktivieren (Full-Screen-Aufnahmen)

Direkt nach dem Home-Dialog erscheint ein zweiter Dialog, sofern das Gerät Android 11+ nutzt und der Bedienungshilfen-Dienst für Screenshots nicht aktiviert ist:

Remote-Aufnahmen aktivieren Damit das RDS-Panel jederzeit Screenshots anfordern kann (auch wenn die App nicht im Vordergrund ist), aktivieren Sie den Bedienungshilfen-Dienst von "Digital Signage RDS". [ Später ] [ Aktivieren ]

Drücken Sie Aktivieren → die Bedienungshilfen-Einstellungen öffnen sich → Heruntergeladene Dienste → Digital Signage RDS → Aktivieren. Bestätigen Sie den Systemhinweis zu den Berechtigungen.

Ohne diesen Dienst:

• Aufnahmen entstehen nur, solange eine Activity des Kiosks im Vordergrund ist.
• Ist der Kiosk abgestürzt oder wird ein Systemdialog angezeigt, erhält das Panel ein Bild des letzten sichtbaren Frames — nicht des aktuellen Bildschirms.

Mit aktiviertem Dienst funktionieren die Aufnahmen immer, umfassen System-UI / Fehlerdialoge / Sperrbildschirm und überstehen Abstürze der Activity (Android stellt das Binding der Bedienungshilfen automatisch wieder her).

Wie beim Home-Dialog: Wenn Sie ihn mit Später schließen, erscheint er bei jedem Start erneut, bis der Dienst aktiviert ist.

Autostart überprüfen

Nach einem Neustart protokolliert der Agent:

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

Wenn Sie die Zeile BroadcastReceived sehen, der Kiosk aber nicht erscheint, fehlt mit ziemlicher Sicherheit der Schritt Home-App. Logs im Panel ansehen: Aktionen → Logs.

Installierte Version

Die Version des Agenten sehen Sie unter Einstellungen → Version. Sie wird außerdem bei jedem Heartbeat an den Server gemeldet und in der Spalte Version der Geräteliste angezeigt.

Mindestens unterstützte Version für Android: 2.0.0. Ältere Versionen zeigen im Panel ein End of Life-Banner.