DokumentationAEMAEM Screens-Anleitung

Implementieren von Android™ Player implementing-android-player

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Intermediate
  • Admin

In diesem Abschnitt wird die Konfiguration des Android™-Players beschrieben. Er enthält Informationen zur Konfigurationsdatei und präsentiert die verfügbaren Optionen und Empfehlungen zu den zum Entwickeln und Testen zu verwendenden Einstellungen.

Außerdem Watchdog ist eine Lösung, um den Player nach Abstürzen wiederherzustellen. Eine Anwendung muss sich beim Watchdog-Dienst registrieren und dann regelmäßig Nachrichten an den Dienst senden, dass er aktiv ist. Falls der Watchdog-Service innerhalb der geforderten Zeit keine Keep-Alive-Nachricht erhält, versucht der Service das Gerät neu zu starten, um eine saubere Wiederherstellung durchzuführen (bei ausreichenden Rechten) oder die Anwendung neu zu starten.

Installieren des Android™-Players installing-android-player

Installieren Sie Android™ Player für AEM Screens, um den Android™ Player für AEM Screens zu implementieren.

Rufen Sie die Seite AEM 6.5 Player-Downloads auf.

Einrichten der Umgebung für das AEM Screens 6.5.5 Service Pack fp-environment-setup

NOTE
Richten Sie eine Umgebung für den Android™-Player ein, wenn Sie das AEM Screens 6.5.5 Service Pack verwenden.

Legen Sie das Attribut „SameSite“ für die Anmelde-Token-Cookies in der Konfiguration der Adobe Experience Manager-Web-Konsole in allen AEM-Autoren- und Veröffentlichungsinstanzen von Lax (Gering) auf None (Keine) fest.

Führen Sie dazu folgende Schritte durch:

  1. Navigieren Sie zur Konfiguration der Adobe Experience Manager-Web-Konsole über http://localhost:4502/system/console/configMgr.

  2. Suchen Sie nach Adobe Granite Token Authentication Handler.

  3. Legen Sie das Attribut „SameSite“ für die Anmelde-Token-Cookies von Lax (Gering) auf None (Keine) fest.
    image

  4. Klicken Sie auf Speichern.

Ad-hoc-Methode ad-hoc-method

Mit der Ad-hoc-Methode können Sie den neuesten Android™ Player (.exe). Rufen Sie die Seite AEM 6.5 Player-Downloads auf.

Nachdem Sie die Anwendung heruntergeladen haben, führen Sie die Schritte im Player aus, um die Ad-hoc-Installation abzuschließen:

  1. Halten Sie die linke obere Ecke gedrückt, um das Admin-Bedienfeld zu öffnen.

  2. Navigieren Sie im linken Aktionsmenü zu Konfiguration, geben Sie den Standort (die Adresse) der AEM-Instanz ein, zu der Sie eine Verbindung aufbauen möchten, und klicken Sie auf Speichern.

  3. Navigieren Sie zum Gerät Registrierung im linken Aktionsmenü, damit Sie den Status des Prozesses zur Geräteregistrierung überprüfen können.

NOTE
Wenn die Variable Bundesland is REGISTRIERT, können Sie sehen, dass die Variable Geräte-ID -Feld gefüllt wird.
Wenn der Status UNREGISTRIERT ist, können Sie das Gerät mithilfe des Tokens registrieren.

Implementieren von Android™ Watchdog implementing-android-watchdog

Aufgrund der Architektur von Android™ muss das neu starten des Geräts über Systemberechtigungen verfügen. Signieren Sie dazu die apk mit den Signierungsschlüsseln des Herstellers. Andernfalls startet Watchdog die Player-Anwendung neu und startet das Gerät nicht neu.

Signage von Android™ apks Verwenden von Herstellerschlüsseln signage-of-android-apks-using-manufacturer-keys

So greifen Sie auf die berechtigten APIs von Android™ zu, z. B. PowerManager oder HDMIControlServices, unterschreiben Sie Android™. apk unter Verwendung der Herstellerschlüssel.

CAUTION
Voraussetzungen:
Sie sollten das Android™ SDK installiert haben, bevor Sie die folgenden Schritte ausführen.

Gehen Sie wie folgt vor, um die Android™-apk mithilfe der Herstellerschlüssel zu signieren:

  1. Laden Sie die apk von Google Play oder von der Seite AEM Screens-Player-Downloads herunter

  2. Besorgen Sie sich die Plattformschlüssel vom Hersteller, damit Sie eine pk8 und pem file

  3. Suchen Sie die apksigner Tool in Android™ sdk mithilfe von find ~/Library/Android/sdk/build-tools -name "apksigner"

  4. <pathto> /apksigner sign --key platform.pk8 --cert platform.x509.pem aemscreensplayer.apk

  5. Suchen Sie den Pfad zum Zip-Ausrichtungs-Tool in Android™ SDK

  6. <pathto> /zipalign -fv 4 aemscreensplayer.apk aemscreensaligned.apk

  7. Installieren Sie aemscreensaligned.apk mithilfe von adb install auf dem Gerät

Grundlegendes zu Android™ Watchdog-Services android-watchdog-services

Der Android-Watchdog-übergreifende Dienst wird als Cordova-Plug-in implementiert, indem er AlarmManager.

Das folgende Diagramm zeigt die Implementierung des Watchdog-Service:

chlimage_1-31

1. Initialisierung - Zum Zeitpunkt der Initialisierung des Cordova-Plug-ins werden die Berechtigungen überprüft, um festzustellen, ob Sie über Systemberechtigungen und somit über die Berechtigung zum Neustart verfügen. Sind diese beiden Kriterien erfüllt, wird ein Pending-Intent für den Neustart erstellt. Andernfalls wird ein Pending-Intent für den Neustart der Anwendung (basierend auf ihrer Startaktivität) erstellt.

2. Keep-Alive-Timer - Ein Keep-Alive-Timer wird verwendet, um alle 15 Sekunden ein Ereignis Trigger. In diesem Fall brechen Sie den vorhandenen Pending-Intent ab (um die App neu zu starten) und registrieren Sie einen neuen Pending-Intent für die gleichen 60 Sekunden in der Zukunft (im Grunde wird der Neustart verschoben).

NOTE
In Android™ wird die AlarmManager wird verwendet, um die pendingIntents kann auch dann ausgeführt werden, wenn die App abgestürzt ist und die Alarmbereitstellung von API 19 (Kitkat) ungenau ist. Zwischen dem Timer-Intervall und dem AlarmManager pendingIntent's Alarm.

3. Anwendungsabsturz - Bei einem Absturz wird der pendingIntent für den Neustart, der beim AlarmManager registriert ist, nicht mehr zurückgesetzt. Daher wird ein Neustart des Programms ausgeführt (abhängig von den zum Zeitpunkt der Initialisierung des Cordova-Plug-ins verfügbaren Berechtigungen).

Massenbereitstellung von Android™ Player bulk-provision-android-player

Wenn der Android™-Player stapelweise eingeführt wird, muss der Player auf eine AEM Instanz verweisen und andere Eigenschaften konfigurieren, ohne diese manuell in die Admin-Benutzeroberfläche eingeben zu müssen.

NOTE
Diese Funktion ist ab Android™ Player 42.0.372 verfügbar.

Gehen Sie wie folgt vor, um die Massenbereitstellung im Android™-Player zuzulassen:

  1. Erstellen Sie eine JSON-Konfigurationsdatei mit dem Namen player-config.default.json.
    Anzeigen einer Beispiel-JSON-Richtlinie und einer Tabelle, die die Verwendung der verschiedenen Richtlinienattribute.

  2. Verwenden Sie einen MDM- oder ADB- oder Android™ Studio-Datei-Explorer, um diese JSON-Richtliniendatei im sdcard auf dem Android™-Gerät.

  3. Nachdem die Datei bereitgestellt wurde, installieren Sie die Player-App mit dem MDM.

  4. Wenn die Player-Anwendung gestartet wird, wird diese Konfigurationsdatei gelesen und auf den entsprechenden AEM-Server verwiesen, auf dem sie registriert und dann gesteuert wird.

    note note
    NOTE
    Diese Datei ist schreibgeschützt wenn die Anwendung zum ersten Mal gestartet wird und nicht für nachfolgende Konfigurationen verwendet werden kann. Wenn der Player vor dem Ablegen der Konfigurationsdatei gestartet wird, deinstallieren Sie die Anwendung einfach und installieren Sie sie erneut auf dem Gerät.

Richtlinienattribute policy-attributes

Die folgende Tabelle fasst zur Referenz die Richtlinienattribute mit einer JSON-Beispielrichtlinie zusammen:

Richtlinienname
Zweck
server
Die URL zum Adobe Experience Manager-Server.
resolution
Die Auflösung des Geräts.
rebootSchedule
Der Zeitplan für den Neustart gilt für alle Plattformen.
enableAdminUI
Aktivierung der Administrator-Benutzeroberfläche zum Konfigurieren des Geräts vor Ort. Stellen Sie diesen Wert auf false ein, sobald die Benutzeroberfläche vollständig konfiguriert ist und in der Produktion verwendet wird.
enableOSD
Aktivierung der Kanalschalter-Benutzeroberfläche, damit Benutzer zwischen Kanälen auf dem Gerät wechseln können. Stellen Sie den Wert ggf. auf false ein, sobald die Benutzeroberfläche vollständig konfiguriert ist und in der Produktion verwendet wird
enableActivityUI
Aktivieren Sie diese Option, wenn Sie den Fortschritt von Aktivitäten wie Download und Synchronisierung anzeigen möchten. Aktivieren Sie diese Option zur Fehlerbehebung und deaktivieren Sie sie, sobald sie vollständig konfiguriert ist und sich in der Produktion befindet.
enableNativeVideo
Aktivieren Sie diese Option, wenn Sie die native Hardwarebeschleunigung für die Videowiedergabe verwenden möchten (nur Android™).

Beispiel für eine JSON-Richtlinie example-json

{
  "server": "https://author-screensdemo.adobecqms.net",
"device": "",
"user": "",
"password": "",
"resolution": "auto",
"rebootSchedule": "at 4:00 am",
"maxNumberOfLogFilesToKeep": 10,
"logLevel": 3,
"enableAdminUI": true,
"enableOSD": true,
"enableActivityUI": false,
"enableNativeVideo": false,
"enableAutoScreenshot": false,
"cloudMode": false,
"cloudUrl": "https://screens.adobeioruntime.net",
"cloudToken": "",
"enableDeveloperMode": true
}
NOTE
Alle Android™-Geräte verfügen über eine *sdcard* Ordner, ob ein tatsächlicher *sdcard* wird eingefügt oder nicht. Diese Datei befindet sich bei Bereitstellung auf derselben Ebene wie der Ordner „Downloads“. Einige MDMs, wie Samsung Knox, sehen dies möglicherweise sdcard Ordnerspeicherort als Interner Speicher.

Massenbereitstellung von Android™-Player mithilfe von Enterprise Mobility Management bulk-provisioning

Bei der Massenbereitstellung des Android™-Players wird es mühsam, jeden Player manuell bei AEM zu registrieren. Es wird dringend empfohlen, eine EMM-Lösung (Enterprise Mobility Management) zu verwenden, z. B. VMWare Airwatch, MobileIron oder Samsung Knox verwenden, um Ihre Implementierung remote bereitzustellen und zu verwalten. Der AEM Screens Android™ Player unterstützt die standardmäßige EMM AppConfig-Lösung, die die Remote-Bereitstellung ermöglicht.

Benennen von Android™ Player name-android

Sie können Ihrem Android™-Player einen benutzerfreundlichen Gerätenamen zuweisen und so den zugewiesenen Gerätenamen an AEM (Adobe Experience Manager) senden. Mit dieser Funktion können Sie nicht nur Ihren Android™-Player benennen, sondern auch mühelos geeignete Inhalte zuweisen.

NOTE
Sie können den Player-Namen nur vor der Registrierung auswählen. Sobald der Player registriert ist, kann der Player-Name nicht mehr geändert werden.

Gehen Sie wie folgt vor, um den Namen im Android™-Player zu konfigurieren:

  1. Navigieren Sie zu settings > Über Geräte
  2. Bearbeiten Sie den Gerätenamen und legen Sie ihn fest, um den Android™-Player zu benennen.

Implementieren der Massenbereitstellung von Android™ Player mithilfe von Enterprise Mobility Management implementation

Gehen Sie wie folgt vor, um die Massenbereitstellung im Android™-Player zuzulassen:

  1. Stellen Sie sicher, dass Ihr Android™-Gerät Google Play-Dienste unterstützt.

  2. Registrieren Sie Ihre Android™-Player-Geräte mit Ihrer bevorzugten EMM-Lösung, die AppConfig unterstützt.

  3. Melden Sie sich bei Ihrer EMM-Konsole an und rufen Sie die AEM Screens Player-Anwendung von Google Play ab.

  4. Wählen Sie die verwaltete Konfiguration oder die zugehörige Option aus.

  5. Sie sollten nun eine Liste der Player-Optionen sehen, die konfiguriert werden können, wie z. B. Server und Massenregistrierungs-Code.

  6. Konfigurieren Sie diese Parameter, speichern Sie sie und stellen Sie die Richtlinie auf den Geräten bereit.

    note note
    NOTE
    Die Geräte sollten das Programm zusammen mit der Konfiguration empfangen und auf den richtigen AEM-Server mit der ausgewählten Konfiguration verweisen. Wenn Sie den Massenregistrierungs-Code konfiguriert haben und ihn so belassen haben, wie er in AEM konfiguriert wurde, sollte sich der Player automatisch registrieren können. Wenn Sie eine Standardanzeige konfiguriert haben, kann sie auch einige Standardinhalte herunterladen und anzeigen (die später nach Belieben geändert werden können).

Wenden Sie sich außerdem an Ihren EMM-Anbieter, wenn Sie Fragen zur AppConfig-Unterstützung haben. Am häufigsten verwendete VMWare Airwatch, Mobile Iron, SOTI, BlackBerry&reg; UEM, IBM&reg; Maas360, und Samsung Knox unterstützen unter anderem diesen Industriestandard.

Verwenden der Fernbedienungs-Steuerung von Screens using-remote-control

AEM Screens bietet Funktionen für die Steuerung per Fernbedienung. Mehr über diese Funktion erfahren Sie hier: Fernbedienungs-Steuerung von Screens

recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053