DocumentationAEMGuide d’AEM Screens

Mise en oeuvre d’Android™ Player implementing-android-player

Last update: Tue Apr 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Intermediate
  • Admin

Cette section décrit la configuration du lecteur Android™. Elle fournit des informations sur le fichier de configuration, les options disponibles, ainsi que des recommandations indiquant quels paramètres utiliser pour le développement et le test.

En outre, Watchdog est une solution permettant de restaurer le lecteur suite à une panne. Une application doit s’enregistrer auprès du service watchdog, puis envoyer régulièrement des messages au service lui indiquant qu’elle est active. Si le service watchdog ne reçoit pas de message de maintien en vie dans un délai spécifié, il tente de redémarrer l’appareil pour une récupération propre (s’il dispose des privilèges suffisants) ou de redémarrer l’application.

Installation d’Android™ Player installing-android-player

Pour mettre en oeuvre le lecteur Android™ pour AEM Screens, installez le lecteur Android™ pour AEM Screens.

Consultez la page Téléchargements du lecteur AEM 6.5.

Configuration de l’environnement pour le Service Pack AEM Screens 6.5.5 fp-environment-setup

NOTE
Configurez un environnement pour le lecteur Android™ si vous utilisez le Service Pack AEM Screens 6.5.5.

Définissez la valeur de SameSite attribute for the login-token cookies de Lax sur None dans Configuration de la console Web Adobe
Experience Manager sur toutes les instances de création et de publication AEM.

Suivez les étapes ci-dessous :

  1. Accédez à Configuration de la console Web Adobe
    Experience Manager     en utilisant http://localhost:4502/system/console/configMgr.

  2. Recherchez Adobe Granite Token Authentication Handler.

  3. Changez la valeur de SameSite attribute for the login-token cookies de Lax à None.
    image

  4. Cliquez sur Save.

Méthode ad hoc ad-hoc-method

La méthode ad hoc vous permet d’installer le dernier lecteur Android™ (.exe). Visitez la page Téléchargements du lecteur AEM 6.5.

Après avoir téléchargé l’application, suivez les étapes du lecteur pour terminer l’installation ad hoc :

  1. Appuyez longuement dans le coin supérieur gauche pour ouvrir le panneau d’administration.

  2. Accédez à Configuration depuis le menu d’actions de gauche et saisissez l’emplacement (adresse) de l’instance AEM à laquelle vous souhaitez vous connecter, puis cliquez sur Enregistrer.

  3. Accédez au Appareil Enregistrement dans le menu d’actions de gauche, afin que vous puissiez vérifier l’état du processus d’enregistrement du périphérique.

NOTE
Si la variable État is ENREGISTRÉ, vous pouvez voir que la variable Identifiant de périphérique est renseigné.
Si le Statut est NON ENREGISTRÉ, vous pouvez utiliser le Jeton pour enregistrer l’appareil.

Mise en oeuvre d’Android™ Watchdog implementing-android-watchdog

En raison de l’architecture d’Android™, le redémarrage de l’appareil requiert que l’application dispose de droits système. Pour ce faire, signez le fichier apk à l’aide des clés de signature du fabricant. Sinon, watchdog redémarre l’application du lecteur et ne redémarre pas l’appareil.

Signature d’Android™ apks Utilisation des clés du fabricant signage-of-android-apks-using-manufacturer-keys

Pour accéder à certaines des API privilégiées d’Android™ telles que PowerManager ou HDMIControlServices, signez Android™ apk à l'aide des clés du fabricant.

CAUTION
Conditions préalables :
Le SDK Android™ doit être installé avant d’effectuer les étapes suivantes.

Suivez les étapes ci-dessous pour signer le fichier apk Android™ à l’aide des clés du fabricant :

  1. Téléchargez le fichier apk à partir de Google Play ou de la page Téléchargements du lecteur AEM Screens

  2. Procurez-vous les clés de plateforme du fabricant pour obtenir un pk8 et un pem fichier

  3. Recherchez la variable apksigner outil dans le sdk Android™ à l’aide de la fonction find ~/Library/Android/sdk/build-tools -name "apksigner"

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

  5. Recherchez le chemin d’accès à l’outil d’alignement zip dans le sdk Android™

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

  7. Installez aemscreensaligned.apk via adb install sur l’appareil.

Présentation des services Android™ Watchdog android-watchdog-services

Le service watchdog Android est mis en oeuvre en tant que module externe Cordova à l’aide de AlarmManager.

Le diagramme suivant illustre la mise en œuvre du service watchdog :

chlimage_1-31

1. Initialisation - Au moment de l’initialisation du module externe Cordova, les autorisations sont vérifiées pour voir si vous disposez des privilèges système et donc de l’autorisation Redémarrer. Si ces deux critères sont satisfaits, une tentative en attente d’exécution de Redémarrer est créée. Dans le cas contraire, une tentative en attente de redémarrage de l’application (en fonction de son activité de lancement) est créée.

2. Minuteur de persistance - Un minuteur de maintien en activité est utilisé pour déclencher un événement toutes les 15 secondes. Dans cet événement, annulez l’intention en attente existante (pour redémarrer l’application) et enregistrez une nouvelle intention en attente pendant les mêmes 60 secondes à l’avenir (en remettant à plus tard le redémarrage).

NOTE
Dans Android™, la variable AlarmManager est utilisé pour enregistrer la variable pendingIntents qui peut s’exécuter même si l’application est en panne et que sa distribution d’alarme est incorrecte à partir d’API 19 (Kitkat). Conserver un espace entre l’intervalle du minuteur et l’événement AlarmManager pendingIntent's alarme.

3. Blocage de l’application - En cas de blocage, le pendingIntent pour le redémarrage enregistré avec AlarmManager n’est plus réinitialisé. Par conséquent, il exécute un redémarrage de l’application (en fonction des autorisations disponibles au moment de l’initialisation du module externe Cordova).

Approvisionnement en masse d’Android™ Player bulk-provision-android-player

Lors du déploiement en masse du lecteur Android™, il est nécessaire de configurer le lecteur pour qu’il pointe vers une instance AEM et configure d’autres propriétés sans les saisir manuellement dans l’interface utilisateur d’administration.

NOTE
Cette fonctionnalité est disponible sur le lecteur Android™ 42.0.372.

Suivez les étapes ci-dessous pour autoriser la mise en service en masse dans le lecteur Android™ :

  1. Créez un fichier de configuration JSON nommé player-config.default.json.
    Voir Exemple de stratégie JSON et un tableau décrivant l’utilisation des différentes Attributs de stratégie.

  2. Utilisez un explorateur de fichiers MDM ou ADB ou Android™ Studio pour déposer ce fichier JSON de stratégie dans sdcard sur l’appareil Android™.

  3. Lorsque le fichier est déployé, utilisez le MDM pour installer l’application du lecteur.

  4. Lorsque l’application du lecteur est lancée, ce fichier de configuration est lu et pointe vers le serveur d’AEM approprié où il est enregistré puis contrôlé.

    note note
    NOTE
    Ce fichier est lecture seule la première fois que l’application est lancée et ne peut pas être utilisée pour les configurations suivantes. Si le lecteur est lancé avant que le fichier de configuration ne soit déposé, il vous suffit de désinstaller et de réinstaller l’application sur l’appareil.

Attributs de politique policy-attributes

Le tableau suivant résume les attributs de politique et inclut un exemple de politique JSON à titre de référence :

Nom de la politique
Objectif
server
L’URL du serveur Adobe Experience Manager.
resolution
Résolution de l’appareil.
rebootSchedule
La programmation du redémarrage s’applique à toutes les plates-formes.
enableAdminUI
Activez l’interface utilisateur d’administration pour configurer l’appareil sur site. Définissez la valeur sur false une fois qu’elle est entièrement configurée et en production.
enableOSD
Activez l’interface utilisateur du sélecteur de canal pour que les utilisateurs changent de canaux sur l’appareil. Pensez à la définir sur false une fois qu’elle est entièrement configurée et en production.
enableActivityUI
Activez cette option si vous souhaitez afficher la progression des activités, telles que le téléchargement et la synchronisation. Activez cette règle pour le dépannage et désactivez-la une fois qu’elle est entièrement configurée et en production.
enableNativeVideo
Activez cette option si vous souhaitez utiliser l’accélération matérielle native pour la lecture vidéo (Android™ uniquement).

Exemple de politique JSON 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
Tous les appareils Android™ ont une *sdcard* dossier si un réel *sdcard* est inséré ou non. Une fois déployé, ce fichier se trouvera au même niveau que le dossier Downloads. Certains MDM, tels que Samsung Knox, peuvent voir ceci : sdcard emplacement du dossier en tant que Stockage interne.

Approvisionnement en masse d’Android™ Player à l’aide de la gestion de la mobilité d’entreprise bulk-provisioning

Lors du déploiement en masse du lecteur Android™, il devient fastidieux d’enregistrer manuellement chaque lecteur avec AEM. Il est vivement recommandé d’utiliser une solution EMM (Enterprise Mobility Management, par exemple), comme VMWare Airwatch, MobileIron ou Samsung Knox pour configurer et gérer votre déploiement à distance. Le lecteur AEM Screens Android™ prend en charge la configuration standard EMM AppConfig pour permettre la mise en service à distance.

Nommage du lecteur Android™ name-android

Vous pouvez attribuer un nom d’appareil convivial à votre lecteur Android™, envoyant ainsi le nom d’appareil attribué à AEM (Adobe Experience Manager). Cette fonctionnalité vous permet non seulement de nommer votre lecteur Android™, mais également d’attribuer facilement le contenu approprié.

NOTE
Vous ne pouvez choisir le nom du lecteur qu’avant l’enregistrement. Une fois le lecteur enregistré, le nom du lecteur ne peut plus être modifié.

Pour configurer le nom dans le lecteur Android™, procédez comme suit :

  1. Accédez à paramètres > A propos du périphérique
  2. Modifiez et définissez le nom de votre appareil pour nommer votre lecteur Android™

Mise en oeuvre de l’approvisionnement en bloc d’Android™ Player à l’aide de la gestion de la mobilité d’entreprise implementation

Suivez les étapes ci-dessous pour autoriser la mise en service en masse dans le lecteur Android™ :

  1. Assurez-vous que votre appareil Android™ prend en charge les services Google Play.

  2. Inscrivez vos appareils de lecteur Android™ à votre solution EMM préférée qui prend en charge AppConfig.

  3. Connectez-vous à votre console EMM et extrayez l’application du lecteur AEM Screens de Google Play.

  4. Cliquez sur l’option de configuration gérée ou associée.

  5. Vous devriez maintenant voir la liste des options du lecteur qui peuvent être configurées, par exemple le code d’enregistrement en bloc et du serveur.

  6. Configurez ces paramètres, enregistrez-les et déployez la stratégie sur les appareils.

    note note
    NOTE
    Les appareils doivent recevoir l’application avec la configuration et pointer vers le serveur AEM approprié avec la configuration sélectionnée. Si vous choisissez de configurer le code d’enregistrement en bloc et que vous le conservez tel que configuré dans AEM, le lecteur doit être en mesure de s’enregistrer automatiquement. Si vous avez configuré un affichage par défaut, il peut également télécharger et afficher du contenu par défaut (qui peut être modifié ultérieurement selon vos besoins).

Vous devez également vérifier auprès de votre fournisseur EMM sur la prise en charge d’AppConfig. Les plus populaires, par exemple VMWare Airwatch, Mobile Iron, SOTI, BlackBerry&reg; UEM, IBM&reg; Maas360, et Samsung Knox parmi d’autres, nous soutenons cette norme industrielle.

Utiliser la commande à distance Screens using-remote-control

AEM Screens offre une fonctionnalité de commande à distance. Pour en savoir plus sur cette fonctionnalité, cliquez ici : Commande à distance Screens

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