Esta seção descreve como configurar o Android player. Ele fornece informações sobre o arquivo de configuração e as opções disponíveis, além de recomendações sobre quais configurações usar para desenvolvimento e teste.
Além disso, Watchdog é uma solução para recuperar o reprodutor de falhas. Um aplicativo precisa se registrar no serviço de vigilância e enviar mensagens periodicamente ao serviço de que está vivo. Caso o serviço de watchdog não receba uma mensagem keep-alive dentro de um tempo determinado, o serviço tenta reinicializar o dispositivo para uma recuperação limpa (se ele tiver os privilégios suficientes) ou reiniciar o aplicativo.
Para implementar o Android Player no AEM Screens, instale o Android Player no AEM Screens.
Visite a página AEM 6.5 Player Downloads.
Você deve configurar um ambiente para o Android player, se estiver usando o AEM Screens 6.5.5 Service Pack.
Defina o atributo SameSite para os cookies do token de login de Lax para None de Configuração do console da Web Adobe Experience Manager em todas as instâncias de criação e publicação AEM.
Siga as etapas abaixo:
Navegue até Configuração do Adobe Experience Manager Web Console usando http://localhost:4502/system/console/configMgr
.
Procure por Adobe Granite Token Authentication Handler.
Defina o atributo SameSite para os cookies do token de login de Lax para None.
Clique em Salvar.
O método Ad-Hoc permite instalar o Player do Android mais recente (.exe). Visite a página AEM 6.5 Player Downloads.
Depois de baixar o aplicativo, siga as etapas no reprodutor para concluir a instalação ad-hoc:
Pressione e segure no canto superior esquerdo para abrir o painel do administrador.
Navegue até Configuration a partir do menu de ação esquerdo e insira o local (endereço) da instância de AEM à qual deseja se conectar e clique em Save.
Navegue até o link Device Registration no menu de ação esquerdo para verificar o status do processo de registro do dispositivo.
Se State for REGISTERED, você notará que o campo Device id será preenchido.
Se State for UNREGISTERED, você poderá usar o Token para registrar o dispositivo.
Devido à arquitetura do Android, a reinicialização do dispositivo requer que o aplicativo tenha privilégios de sistema. Para fazer isso, é necessário assinar o apk usando as chaves de assinatura do fabricante; caso contrário, o watchdog reiniciará o aplicativo do reprodutor e não reinicializará o dispositivo.
Para acessar algumas das APIs privilegiadas do Android, como PowerManager ou HDMIControlServices, é necessário assinar o painel do Android usando as chaves do fabricante.
Pré-requisitos:
Você deve ter o SDK do android instalado antes de executar as etapas a seguir.
Siga as etapas abaixo para assinar o aplicativo android usando as chaves do fabricante:
Baixe o apk do Google Play ou da página Downloads do AEM Screens Player
Obtenha as chaves da plataforma do fabricante para obter um pk8 e um arquivo pem
Localize a ferramenta do assinante no sdk do android usando find ~/Library/Android/sdk/build-tools -name "apksigner"
<pathto> /apksigner sign —key platform.pk8 —cert platform.x509.pem aemscreensplayer.apk
Encontre o caminho para a ferramenta zip align no android sdk
<pathto> /zipalign -fv 4 aemscreensplayer.apk aemscreensalign.apk
Instale o aemscreensalign.apk usando a instalação do adb no dispositivo
O serviço de monitoramento entre Android é implementado como um plug-in cordova usando AlarmManager.
O diagrama a seguir mostra a implementação do serviço de vigilância:
1. Inicialização No momento da inicialização do plug-in cordova, as permissões são verificadas para ver se temos privilégios de sistema e, portanto, a permissão Reinicialização . Se esses dois critérios forem atendidos, um Propósito pendente de reinicialização será criado; caso contrário, um Propósito pendente de reiniciar o aplicativo (com base em sua Atividade de inicialização) será criado.
2. Keep Alive Timer Um temporizador keep alive é usado para acionar um evento a cada 15 segundos. Nesse caso, você precisa cancelar a intenção pendente existente (para reiniciar ou reiniciar o aplicativo) e registrar uma nova intenção pendente por 60 segundos no futuro (essencialmente adiar a reinicialização).
No Android, o AlarmManager é usado para registrar o pendingIntents que pode ser executado mesmo que o aplicativo tenha travado e a entrega do alarme seja inexata da API 19 (Kitkat). Mantenha algum espaçamento entre o intervalo do cronômetro e o alarme AlarmManager's pendingIntent's.
3. Falha do aplicativo No caso de uma falha, o pendingIntent for Reboot registrado com o AlarmManager não é mais redefinido e, portanto, executa uma reinicialização ou reinicialização do aplicativo (dependendo das permissões disponíveis no momento da inicialização do plug-in cordova).
Ao implantar o reprodutor do Android em massa, é necessário provisionar o reprodutor para apontar para uma instância do AEM, bem como configurar outras propriedades sem inseri-las manualmente na interface do usuário do administrador.
Esse recurso está disponível no Android player 42.0.372.
Siga as etapas abaixo para permitir o provisionamento em massa no reprodutor Android:
Crie um arquivo JSON de configuração com o nome player-config.default.json
.
Consulte um Exemplo de política JSON, bem como uma tabela que descreve o uso dos vários Atributos de política.
Use um explorador de arquivos MDM ou ADB ou Android Studio para soltar esse arquivo JSON de política na pasta sdcard no dispositivo Android.
Depois que o arquivo for implantado, use o MDM para instalar o aplicativo do reprodutor.
Quando o aplicativo do reprodutor for iniciado, ele lerá esse arquivo de configuração e apontará para o servidor de AEM aplicável, onde ele pode ser registrado e controlado posteriormente.
Este arquivo é somente leitura na primeira vez que o aplicativo é iniciado e não pode ser usado para configurações subsequentes. Se o reprodutor for iniciado antes da queda do arquivo de configuração, basta desinstalar e reinstalar o aplicativo no dispositivo.
A tabela a seguir resume os atributos de política com um exemplo de JSON de política para referência:
Nome da política | Propósito |
---|---|
server | O URL para o servidor Adobe Experience Manager. |
resolução | A resolução do dispositivo. |
reotSchedule | O agendamento para reinicialização se aplica a todas as plataformas. |
enableAdminUI | Ative a interface do usuário do administrador para configurar o dispositivo no site. Defina como false assim que estiver totalmente configurado e em produção. |
enableOSD | Ative a interface do usuário do seletor de canal para que os usuários alternem os canais no dispositivo. Considere configurar para false assim que estiver totalmente configurado e em produção. |
enableActivityUI | Ative para mostrar o progresso de atividades como download e sincronização. Ative para solução de problemas e desative assim que estiver totalmente configurado e em produção. |
enableNativeVideo | Ative o uso da aceleração de hardware nativa para reprodução de vídeo (somente Android). |
{
"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
}
Todos os dispositivos Android têm uma pasta sdcard se um sdcard real estiver inserido ou não. Esse arquivo, quando implantado, estaria no mesmo nível da pasta Downloads. Alguns MDMs como Samsung Knox podem se referir a esse local de pasta sdcard como Internal storage.
Ao implantar o reprodutor Android em massa, é entediante registrar manualmente cada reprodutor com AEM. É altamente recomendável usar uma solução EMM (Enterprise Mobility Management) como VMWare Airwatch, MobileIron ou Samsung Knox para provisionar e gerenciar remotamente sua implantação. O AEM Screens Android player é compatível com o EMM AppConfig padrão do setor para permitir provisionamento remoto.
Siga as etapas abaixo para permitir o provisionamento em massa no Android Player:
Certifique-se de que o dispositivo Android seja compatível com os serviços do Google Play.
Registre seus dispositivos Android player com sua solução EMM favorita compatível com o AppConfig.
Faça logon no console do EMM e extraia o aplicativo AEM Screens Player do Google Play.
Selecione a opção de configuração gerenciada ou a opção relacionada.
Agora você deve ver uma lista de opções do player que podem ser configuradas, como servidor e código de registro em massa.
Configure esses parâmetros, salve e implante a política nos dispositivos.
Os dispositivos devem receber o aplicativo junto com a configuração e apontar para o servidor de AEM correto com a configuração selecionada. Se você optar por configurar o código de registro em massa e mantê-lo igual ao configurado no AEM, o reprodutor deverá ser capaz de se registrar automaticamente. Se você tiver configurado uma exibição padrão, ela também poderá baixar e mostrar algum conteúdo padrão (que poderá ser alterado posteriormente de acordo com sua conveniência).
Além disso, verifique com seu fornecedor de EMM o suporte ao AppConfig. Os mais populares, como VMWare Airwatch, Mobile Iron, SOTI, Blackberry UEM, IBM Maas360 e Samsung Knox 1/> entre outros, são compatíveis com esse padrão do setor.