Implementação do Android Player

Última atualização em 2023-05-20
  • Criado para:
  • Intermediate
    Admin

Esta seção descreve a configuração do Android Player. Ele fornece informações do 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 O é uma solução para recuperar o reprodutor de falhas. Um aplicativo precisa se registrar no serviço de vigia e enviar periodicamente mensagens para o serviço informando que ele está ativo. Caso o serviço de vigia não receba uma mensagem de manutenção de atividade em um tempo estipulado, o serviço tentará reinicializar o dispositivo para uma recuperação limpa (se ele tiver privilégios suficientes) ou reiniciar o aplicativo.

Instalação do Android Player

Para implementar o Android Player para AEM Screens, instale o Android Player para AEM Screens.

Visite o Downloads do reprodutor AEM 6.5 página.

Configuração do ambiente para o AEM Screens 6.5.5 Service Pack

OBSERVAÇÃO

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 de token de logon de Lax para Nenhum de Configuração do console da Web do Adobe Experience Manager em todas as instâncias de autor e publicação do AEM.

Siga as etapas abaixo:

  1. Navegue até Configuração do console da Web do Adobe Experience Manager usar http://localhost:4502/system/console/configMgr.

  2. Pesquisar por Manipulador de autenticação de token do Adobe Granite.

  3. Defina o Atributo SameSite para os cookies de token de logon de Lax para Nenhum.
    imagem

  4. Clique em Salvar.

Método Ad-Hoc

O método Ad-Hoc permite instalar o Player mais recente do Android (.exe). Visita Downloads do reprodutor AEM 6.5 página.

Depois de baixar o aplicativo, siga as etapas no reprodutor para concluir a instalação ad-hoc:

  1. Pressione e segure no canto superior esquerdo para abrir o painel de administração.

  2. Navegue até Configuração no menu de ação esquerdo, digite o local (endereço) da instância de AEM à qual deseja se conectar e clique em Salvar.

  3. Navegue até a Dispositivo Registro no menu de ação esquerdo para verificar o status do processo de registro do dispositivo.

OBSERVAÇÃO

Se a variável Estado é REGISTRADO, você observará o ID do dispositivo será preenchido.

Se a variável Estado é NÃO REGISTRADO, você pode usar o Token para registrar o dispositivo.

Implementação do Watchdog do Android

Devido à arquitetura do Android, a reinicialização do dispositivo requer que o aplicativo tenha privilégios de sistema. Para fazer isso, você precisa assinar o apk usando as chaves de assinatura do fabricante, caso contrário, o watchdog reiniciará o aplicativo de reprodução e não reinicializará o dispositivo.

Sinalização de apks Android usando chaves do fabricante

Para acessar algumas APIs privilegiadas do Android, como PowerManager ou HDMIControlServices, você precisa assinar o apk android usando as chaves do fabricante.

ATENÇÃO

Pré-requisitos:

Você deve ter o Android SDK instalado antes de executar as etapas a seguir.

Siga as etapas abaixo para assinar o apk android usando as chaves do fabricante:

  1. Baixe o aplicativo da Google Play ou do Downloads do AEM Screens Player página

  2. Obtenha as chaves de plataforma do fabricante para obter um pk8 e uma pem arquivo

  3. Localize a ferramenta apksigner no Android Sdk usando find ~/Library/Android/sdk/build-tools -name "apksigner"

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

  5. Encontre o caminho para a ferramenta de alinhamento do zip no Android Sdk

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

  7. Instalar aemscreensaligned.apk usando adb install para o dispositivo

Noções básicas sobre os serviços de Watchdog do Android

O serviço de vigia entre Android é implementado como um plug-in cordova usando GerenciadorDeAlarmes.

O diagrama a seguir mostra a implementação do serviço de vigia do:

chlimage_1-31

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 Reinicializar. Se esses dois critérios forem atendidos, uma intenção pendente de reinicialização será criada; caso contrário, uma intenção pendente de reiniciar o aplicativo (com base em sua atividade de inicialização) será criada.

2. Temporizador Keep Alive Um temporizador keep-alive é usado para acionar um evento a cada 15 segundos. Nesse caso, é necessário cancelar a intenção pendente existente (reinicializar ou reiniciar o aplicativo) e registrar uma nova intenção pendente pelos mesmos 60 segundos no futuro (essencialmente adiando a reinicialização).

OBSERVAÇÃO

No Android, a variável GerenciadorDeAlarmes é usado para registrar o pendingIntents que pode ser executado mesmo se o aplicativo tiver falhado e o delivery do alarme for inexato da API 19 (Kitkat). Mantenha algum espaçamento entre o intervalo do cronômetro e o do AlarmManager pendingIntent alarme.

3. Falha do aplicativo No caso de uma falha, o pendingIntent para reinicialização 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).

Provisionamento em massa do Android Player

Ao implantar o reprodutor Android em massa, é necessário provisionar o reprodutor para apontar para uma instância de AEM, bem como configurar outras propriedades sem inserir manualmente essas propriedades na interface do administrador.

OBSERVAÇÃO

Esse recurso está disponível no Android player 42.0.372.

Siga as etapas abaixo para permitir o provisionamento em massa no reprodutor Android:

  1. Crie um arquivo JSON de configuração com o nome player-config.default.json.
    Consulte uma Exemplo de política JSON bem como uma tabela que descreve a utilização dos vários Atributos da política.

  2. Use um explorador de arquivos MDM, ADB ou Android Studio para soltar esse arquivo JSON de política no sdcard no dispositivo Android.

  3. Depois que o arquivo for implantado, use o MDM para instalar o aplicativo do reprodutor.

  4. Quando o aplicativo reprodutor for iniciado, ele lerá esse arquivo de configuração e apontará para o servidor AEM aplicável, onde ele poderá ser registrado e controlado subsequentemente.

    OBSERVAÇÃO

    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 que o arquivo de configuração seja descartado, basta desinstalar e reinstalar o aplicativo no dispositivo.

Atributos da política

A tabela a seguir resume os atributos da política com um exemplo de JSON de política para referência:

Nome da política Propósito
servidor O URL para o servidor do Adobe Experience Manager.
resolução A resolução do dispositivo.
rebootSchedule O cronograma para reinicializar se aplica a todas as plataformas.
enableAdminUI Habilite a interface do Administrador para configurar o dispositivo no site. Defina como false depois que estiver totalmente configurado e em produção.
enableOSD Habilite a interface do alternador de canal para que os usuários alternem canais no dispositivo. Considere configurar como false depois que estiver totalmente configurado e em produção.
enableActivityUI Permite mostrar o progresso de atividades como download e sincronização. Ative para solução de problemas e desative depois que estiver totalmente configurado e em produção.
enableNativeVideo Permitir o uso da aceleração de hardware nativa para reprodução de vídeo (somente Android).

Exemplo de política 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
}
OBSERVAÇÃO

Todos os dispositivos Android têm um sdcard pasta se um real sdcard foi inserido ou não. Esse arquivo, quando implantado, estaria no mesmo nível que a pasta Downloads. Alguns MDMs, como Samsung Knox, podem se referir a isso sdcard local da pasta como Armazenamento interno.

Provisionamento em massa do Android Player usando o Enterprise Mobility Management

Ao implantar o reprodutor Android em massa, é entediante registrar manualmente cada um dos reprodutores 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 oferece suporte ao EMM AppConfig padrão do setor para permitir o provisionamento remoto.

Nomeação do reprodutor Android

Você pode atribuir um nome de dispositivo amigável ao seu reprodutor Android, enviando assim o nome de dispositivo atribuído ao Adobe Experience Manager (AEM). Esse recurso não só permite nomear o player do Android, como também permite atribuir facilmente o conteúdo apropriado.

OBSERVAÇÃO

Você pode escolher o nome do Player somente antes do registro. Depois que o Player é registrado, o nome do Player não pode mais ser alterado.

Siga as etapas abaixo para configurar o nome no reprodutor Android:

  1. Navegue até configurações —> Sobre o dispositivo
  2. Edite e defina o nome do dispositivo para nomear o player do Android

Implementação do provisionamento em massa do Android Player usando o Gerenciamento de mobilidade empresarial

Siga as etapas abaixo para permitir o provisionamento em massa no Android Player:

  1. Verifique se o dispositivo Android oferece suporte aos serviços da Google Play.

  2. Inscreva seus dispositivos Android player com sua solução EMM favorita compatível com AppConfig.

  3. Faça logon no console do EMM e extraia o aplicativo AEM Screens Player do Google Play.

  4. Selecione a configuração gerenciada ou a opção relacionada.

  5. Agora você deve ver uma lista de opções do player que podem ser configuradas, como servidor e código de registro em massa.

  6. Configure esses parâmetros, salve e implante a política nos dispositivos.

    OBSERVAÇÃO

    Os dispositivos devem receber o aplicativo junto com a configuração e apontar para o servidor AEM correto com a configuração selecionada. Se você optar por configurar o código de registro em massa e mantê-lo conforme 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, você deve consultar o fornecedor de EMM sobre o suporte ao AppConfig. Os mais populares, como VMWare Airwatch, Ferro móvel, SOTI, UEM do Blackberry, IBM Maas360 e Samsung Knox entre outros, suportam esse padrão do setor.

Uso do controle remoto do Screens

O AEM Screens oferece a funcionalidade de Controle remoto. Saiba mais sobre esse recurso aqui: Controle remoto do Screens

Nesta página