Mise en œuvre d’Android Player implementing-android-player
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.
Par ailleurs, Watchdog est une solution permettant de restaurer le lecteur suite à une panne. Les applications doivent s’inscrire auprès du service watchdog, puis envoyer régulièrement des messages au service lui indiquant qu’elles sont actives. Au cas où le service watchdog ne reçoit pas de message de maintien en activité dans le délai imparti, le service tente de redémarrer l’appareil pour une restauration propre (s’il dispose des droits suffisants) ou de redémarrer l’application.
Installation d’Android Player installing-android-player
Pour mettre en œuvre Android Player pour AEM Screens, installez Android Player 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
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 :
-
Accédez à Configuration de la console Web Adobe
Experience Manager en utilisanthttp://localhost:4502/system/console/configMgr
. -
Recherchez Adobe Granite Token Authentication Handler.
-
Changez la valeur de SameSite attribute for the login-token cookies de Lax à None.
-
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.
Une fois l’application téléchargée, suivez les étapes du lecteur pour terminer l’installation ad hoc :
-
Appuyez longuement dans l’angle supérieur gauche pour ouvrir le panneau d’administration.
-
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.
-
Accédez au lien Device Registration (Enregistrement de l’appareil) depuis le menu d’actions de gauche pour vérifier le statut du processus d’enregistrement de l’appareil.
Mise en œuvre d’Android Watchdog implementing-android-watchdog
En raison de l’architecture d’Android, le redémarrage de l’appareil requiert que l’application dispose d’autorisations système. Pour ce faire, vous devez signer le fichier apk à l’aide des clés de signature du fabricant, faute de quoi le service watchdog redémarre l’application du lecteur, mais pas l’appareil.
Signature de fichiers apk Android à l’aide 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, vous devez signer le fichier apk Android à l’aide des clés du fabricant.
Suivez les étapes ci-dessous pour signer le fichier apk Android à l’aide des clés du fabricant :
-
Téléchargez le fichier apk à partir de Google Play ou de la page Téléchargements du lecteur AEM Screens
-
Procurez-vous les clés de plateforme du fabricant pour obtenir un fichier pk8 et pem
-
Localisez l’outil apksigner dans le SDK Android à l’aide de la commande find ~/Library/Android/sdk/build-tools -name "apksigner"
-
<pathto> /apksigner sign --key platform.pk8 --cert platform.x509.pem aemscreensplayer.apk
-
Recherchez le chemin d’accès à l’outil d’alignement zip dans le SDK Android.
-
<pathto> /zipalign -fv 4 aemscreensplayer.apk aemscreensaligned.apk
-
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 œuvre en tant que module externe cordova via AlarmManager.
Le diagramme suivant illustre la mise en œuvre du service watchdog :
1. Initialisation Au moment de l’initialisation du module externe cordova, les autorisations sont vérifiées pour voir si nous disposons des autorisations 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 maintien en activité Un minuteur de maintien en activité est utilisé pour déclencher un événement toutes les 15 secondes. Dans cet événement, vous devez annuler la tentative en attente existante (pour redémarrer l’application) et enregistrer une nouvelle tentative en attente pour les mêmes 60 secondes à l’avenir (en remettant à plus tard le redémarrage).
3. Panne d’application En cas de panne, le pendingIntent pour la commande Redémarrer enregistré avec AlarmManager n’est plus réinitialisé et donc exécute un redémarrage de l’application (en fonction des autorisations disponibles lors de l’initialisation du module externe cordova).
Approvisionnement en masse d’Android Player bulk-provision-android-player
Lors de l’approvisionnement en masse d’Android Player, vous devez pouvoir configurer le lecteur pour qu’il pointe vers une instance AEM et pouvoir configurer d’autres propriétés sans les entrer manuellement par le biais de l’interface utilisateur d’administration.
Suivez les étapes ci-dessous pour autoriser l’approvisionnement en masse dans Android Player :
-
Créez un fichier de configuration JSON nommé
player-config.default.json
.
Reportez-vous à l’exemple de règle JSON ainsi qu’au tableau qui décrit l’utilisation des différents attributs de règle. -
Utilisez un explorateur de fichiers MDM ou ADB ou Android Studio pour déposer ce fichier de règle JSON dans le dossier sdcard de l’appareil Android.
-
Une fois le fichier déployé, utilisez le MDM pour installer l’application du lecteur.
-
L’application du lecteur, une fois lancée, lit ce fichier de configuration et pointe vers le serveur AEM approprié, où elle peut ensuite s’enregistrer et être contrôlée.
note note NOTE Ce fichier est en lecture seule la première fois que l’application est lancée et ne peut pas être utilisé pour les configurations suivantes. Si le lecteur est lancé avant que le fichier de configuration ne soit supprimé, il vous suffit de désinstaller et de réinstaller l’application sur l’appareil.
Attributs de règle policy-attributes
Le tableau suivant récapitule les attributs de règle et fournit un exemple de fichier JSON de règle pour référence :
Exemple de règle 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
}
Approvisionnement en bloc d’un lecteur Android à l’aide d’Enterprise Mobility Management bulk-provisioning
Lors du déploiement en bloc d’un lecteur Android, il devient fastidieux d’enregistrer manuellement chaque lecteur dans AEM. Nous vous recommandons vivement d’utiliser une solution EMM (Enterprise Mobility Management) telle que VMWare Airwatch, MobileIron ou Samsung Knox pour configurer et gérer votre déploiement à distance. Le lecteur Android AEM Screens prend en charge la norme EMM AppConfig pour permettre l’approvisionnement à distance.
Nommage d’un lecteur Android name-android
Vous pouvez attribuer un nom d’appareil convivial à votre lecteur Android et envoyer le nom d’appareil choisi à Adobe Experience Manager (AEM). Cette fonctionnalité vous permet non seulement de nommer votre lecteur Android, mais également d’attribuer facilement le contenu approprié.
Pour configurer le nom dans le lecteur Android, procédez comme suit :
- Accédez à Paramètres > À propos de l’appareil
- Modifiez et définissez le nom de votre appareil pour nommer votre lecteur Android
Mise en œuvre de l’approvisionnement en bloc du lecteur Android à l’aide d’une solution Enterprise Mobility Management implementation
Suivez les étapes ci-dessous pour autoriser l’approvisionnement en bloc dans le lecteur Android Player :
-
Assurez-vous que votre périphérique Android prend en charge les services Google Play.
-
Enregistrez vos périphériques de lecteur Android dans votre solution EMM préférée prenant en charge AppConfig.
-
Connectez-vous à votre console EMM et extrayez l’application du lecteur AEM Screens de Google Play.
-
Sélectionnez Configuration gérée ou l’option associée.
-
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.
-
Configurez ces paramètres, enregistrez-les et déployez la stratégie sur les périphériques.
note note NOTE Les périphériques 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 un certain contenu par défaut (qui peut être modifié ultérieurement selon vos besoins).
En outre, vous devez vérifier auprès de votre fournisseur de solution EMM si celle-ci prend AppConfig. Les plus populaires, parmi lesquels VMWare Airwatch, Mobile Iron, SOTI, Blackberry UEM, IBM Maas360 et Samsung Knox, prennent en charge cette solution standard dans ce domaine.
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 : Contrôle à distance Screens.