Perguntas frequentes da AEM Screens

A seção a seguir fornece respostas para algumas das perguntas frequentes mais frequentes relacionadas a um projeto da AEM Screens.

Problema de tela em branco

1. Quais devem ser as etapas de solução de problemas de primeiros socorros para qualquer cliente que esteja voltado para uma tela preta ou que não esteja reproduzindo conteúdo?

• Verifique se a pré-visualização do canal está funcionando.
• Verifique se a pré-visualização do monitor está funcionando
• Tente registrar o player como uma extensão do navegador no seu sistema para a mesma tela e verifique se isso está funcionando.
• Com o player em execução no sistema, navegue até http://localhost:24502. Verifique se todo o conteúdo foi baixado corretamente.
• Verifique se as representações apropriadas foram criadas e se a representação correta está sendo reproduzida.
• Verifique se há algum conteúdo programado e se os horários estão corretos. Verifique se o tempo configurado no player está correto.
• Inspect os registros do console do player e verifique se há erros. Clique com o botão direito do mouse e inspecione para ver os registros do console. Se estiver usando o Windows player, pressione CTRL + ALT +I para ativar o console dev para visualização dos registros.

2. Como resolver problemas de tela cinza no AEM Screens criando um Canal padrão ou um agendamento?

Para evitar telas em branco ou cinza no campo, crie um canal global padrão ou uma programação, atribuída a cada tela com prioridade mínima 1. Caso ocorra algum problema com as atualizações de conteúdo (devido à rede, player, servidor ou replicação), já que os players já possuem esse conteúdo em cache no disco, que deve ser reproduzido normalmente e evitar telas cinza.

Todo o outro conteúdo, como canais ou agendamentos, terá prioridade maior que 1, de modo que o outro conteúdo tenha prioridade e o canal global ou conteúdo de agendamento (com prioridade 1) será reproduzido somente como opção de fallback.

Gerenciamento de canais

1. Qual é a diferença entre um canal on-line e off-line?

Um Canal online mostrará o conteúdo atualizado no ambiente em tempo real, enquanto um Canal offline mostrará o conteúdo em cache.

2. Como faço para fazer um canal on-line?

Selecione o canal e navegue até as propriedades do canal na barra de ações. Marque Modo do desenvolvedor (forçar o canal a ficar online) na guia Canal para colocar o canal online.

3. Qual é o uso do campo Função do Canal?

A função do Canal é a abstração do canal real que é executado para que o autor possa focar diretamente na experiência genérica. Você pode pensar nele como um tipo de tag que identifica exclusivamente o canal em seu contexto (exibição ou programação).

4. Como a resolução real do canal acontece?

Para referências estáticas, a resolução segue apenas o caminho especificado.

Para referências dinâmicas, a resolução ocorre quando o canal é atribuído à exibição (não ao agendamento). O caminho de exibição torna-se o contexto do canal e a resolução ocorre da seguinte forma (prioridade de mais alta a mais baixa):

1. A exibição tem um nó filho que corresponde ao nome do canal referenciado
2. A exibição tem um nó irmão que corresponde ao nome do canal referenciado
3. O local pai da exibição tem um nó filho que corresponde ao nome do canal referenciado
4. O local principal da exibição tem um nó filho que corresponde ao nome do canal referenciado

E assim por diante, até você chegar à pasta de locais e parar lá no momento (de modo que não seja possível fazer referência a um canal que estaria na pasta canais, por exemplo, apenas canais na subárvore de locais).

Registro do dispositivo

1. Se eu descobrir pontos de extremidade, como solicitações de integração e registro de dispositivos, posso escrever um grande número de dispositivos e registrar esses dispositivos. Além de bloquear esse acesso a uma ramificação Wi-Fi, é possível proteger essas solicitações?

Atualmente, o registro só é possível na instância do autor. Embora o serviço de registro não esteja autenticado, ele só criará um dispositivo pendente no AEM e não registrará o dispositivo nem atribuirá qualquer exibição.

Para registrar um dispositivo (o que significa criar um usuário para o dispositivo no AEM), ainda é necessário autenticar para AEM e, no momento, seguir manualmente o assistente de registro para concluir o registro. Teoricamente, um usuário mal-intencionado pode criar vários dispositivos pendentes, mas não pode se registrar sem um logon AEM.

2. Há alguma forma de transformar solicitações de GET HTTP em POST HTTP com alguma forma de autenticação?

A solicitação de registro é uma solicitação de POST.

É recomendável obter a ID do dispositivo da sessão em vez de passá-la como parâmetro. Isso limparia os registros do servidor, o cache do navegador e assim por diante. Atualmente, não se trata de um problema de segurança. Observe que a GET semântica é usada quando não há alteração de estado no servidor e a POST é usada quando há uma alteração de estado.

3. Há uma maneira de recusar uma solicitação de registro de dispositivo?

Não é possível recusar as solicitações de registro. Em vez disso, as solicitações de registro devem expirar após um tempo limite configurado em Adobe Experience Manager Web Console. Por padrão, esse valor é definido como um dia e é armazenado em um cache de memória.

Relatórios de monitoramento e integridade do dispositivo

1. Como soluciono problemas se meu AEM Screens player exibir tela em branco?

Verifique as seguintes possibilidades para solucionar o problema de tela em branco:

• AEM não consegue mover o conteúdo offline
• Canal não tem conteúdo
• Nenhum dos ativos está programado para mostrar no momento atual

2. O que devo fazer se o AEM Screens player não conseguir se registrar e seu estado for exibido como Falha?

É necessário ativar o Filtro de Quem indicou Apache Sling Permitir vazio. Isso é necessário para a operação ideal do protocolo de controle entre o AEM Screens Player e o servidor AEM Screens.

1. Navegue até Configuração do Adobe Experience Manager Web Console
2. Verifique a opção allow.empty.
3. Clique em Salvar.

3. Como solucionar problemas se, ao registrar um AEM Screens player, o dispositivo mostrar FAILURE e os registros do console exibirem o erro ENAME_NOT_FOUND?

Esse problema pode ocorrer se o player não conseguir localizar o DNS do AEM Screens Server. Você pode tentar usar o endereço IP para se conectar. Para obter o IP do servidor, use: arp <server_dns_name>.

4. O AMS recomenda implementar um Android Watchdog em todos os dispositivos? O plug-in Watchdog (Cordova) está incluído no APK?

Um monitor Android de plataforma cruzada usando APIs Android puras já faz parte do aplicativo. Nenhum software adicional é necessário, mas dependendo do dispositivo usado, talvez seja necessário renunciar ao aplicativo para obter privilégios de sistema para um ciclo de alimentação completo (PowerManager api). Se não for demitido usando as teclas do fabricante, ele encerrá e reiniciará o aplicativo, mas não iniciará o ciclo de alimentação.

Para obter mais informações sobre como implementar o Android Player, consulte Implementação do Android Player.

5. Que ferramentas de monitoramento remoto e alerta de terceiros (software) o Adobe/AMS recomenda para monitorar cada dispositivo?

Dependendo do que você deseja para fora do monitoramento e dos alertas, um novo recurso do serviço AEM Screens Notifications notifica você se um dispositivo não tiver feito o ping em algum tempo. As ferramentas de terceiros dependerão do sistema operacional (SO), dos recursos e das necessidades específicas do cliente.

Para obter mais informações sobre onde você pode monitorar a atividade do dispositivo, consulte AEM Screens Notifications Service.

Player do AEM Screens

1. Como instalar o ChromeOS player como plug-in Chrome Browser?

O ChromeOS player pode ser instalado como plug-in do Chrome Browser no modo de desenvolvedor, sem a necessidade de um dispositivo de player de cromo. Para a instalação, siga as etapas abaixo:

1. Clique aqui para baixar o Chrome Player mais recente.
2. Descompacte e salve no disco.
3. Abra o navegador Chrome e selecione Extensões no menu ou navegue diretamente para chrome://extensions.
4. Ative o modo Desenvolvedor a partir do canto superior direito.
5. Clique em Carregar descompactado no canto superior esquerdo e carregue o Chrome Player descompactado.
6. Verifique o plug-in AEM Screens Chrome Player se estiver disponível na lista de extensões.
7. Abra uma nova guia e clique no ícone Aplicativos no canto superior esquerdo ou navegue diretamente para chrome://apps.
8. Clique em AEM Screens Plug-in para iniciar o Chrome Player. Por padrão, o player é iniciado no modo de tela cheia. Pressione esc para sair do modo de tela cheia.

2. Como solucionar problemas se o Screens player não puder ser autenticado por meio da instância de publicação com o manipulador de erros personalizado?

Quando o AEM Screens player é start, ele faz uma solicitação para /content/screens/svc.ping.json, quando o player recebe um erro 404. O player inicia uma solicitação de autenticação para autenticação na instância de publicação. Se houver um manipulador de erros personalizado na instância de publicação, verifique se você retorna o código de status 404 para o usuário anônimo em /content/screens/svc.ping.json.

3. Como definir a tela do dispositivo para permanecer em um Android Player?

Siga as etapas abaixo para ativar a opção Fique acordado em qualquer player Android:

1. Navegue até as configurações do player do Android —> Sobre
2. Toque 7 vezes no número de compilação para habilitar Opções do desenvolvedor em Configurações
3. Navegue até Opções do desenvolvedor
4. Habilitar Fique Acordado

4. Como ativar o modo de janela para o Windows player?

Não há modo de janela no Windows player. É sempre o modo de tela cheia.

5. Como solucionar problemas se um AEM Screens player envia continuamente solicitações de logon?

Siga as etapas abaixo para solucionar problemas de um AEM Screens player que envia solicitações continuamente para /content/screens/svc.json e /libs/granite/core/content/login.validate/j_security_check:

1. Quando o AEM Screens player é start, ele solicita /content/screens/svc.json. Quando o player recebe um código de status 404 na resposta, ele inicia uma solicitação de autenticação usando /libs/granite/core/content/login.validate/j_security_check contra a instância publish. Se houver um manipulador de erros personalizado na instância publish, retorne o código de status 404 para um usuário anônimo em /content/screens/svc.json ou /content/screens/svc.ping.json.

2. Verifique se a configuração do dispatcher permite essas solicitações no /filters.

   Consulte Configurando Filtros de tela para obter mais detalhes.

3. Verifique se as regras de regravação do despachante estão regravando qualquer um dos caminhos de tela para um caminho diferente.

4. Verifique se você tem /etc/map regras na instância author ou publish e os caminhos de telas correspondem a sling:match e são redirecionados internamente para um caminho diferente. Resolver o url exato em /system/console/jcrresolver ajuda a identificar se a instância publish está regravando esses URLs para qualquer outro caminho.

5. Verifique se a configuração do Apache Sling Resource Resolver Fatory está causando regravações internas.

6. Como obter os detalhes da exibição e do dispositivo da API do player?

Você pode obter os detalhes da tela e do dispositivo por meio de:

• uma API JS interna

• uma loja do ContextHub: Três armazenamentos do ContextHub são definidos /libs/screens/clientlibs/contexthub para expor canais, dispositivos e informações de exibição.

  Siga as etapas abaixo para usar esses valores de armazenamento do ContentHub:

  • Edite as propriedades do canal e defina o caminho do ContextHub na guia personalização para o valor (como mencionado acima)

  • No canal JS, você pode usar:

       ContextHub.getStore('screens-device');
       ContextHub.getStore('screens-display');
       ContextHub.getStore('screens-channels');
    

Dicas gerais de solução de problemas

1. Como desativar o Livefyre para evitar erros de tela A/P?

Para desativar o Livefyre para evitar erros de registro:

1. Desative o pacote Livefyre:

   • Vá até https://<host>:<port>/system/console/bundles
   • Procure o pacote AEM Livefyre: com.adobe.cq.social.cq-social-livefyre
   • Clique em Parar

2. Desative o Livefyre poller:

   • No CRXDE Lite, navegue até /etc/importers/polling/livefyre-poller/jcr:content
   • Adicionar uma nova propriedade enabled digite Boolean
   • Defina propriedade ativada como false

2. Como adicionar informações do índice Oak?

A AEM Screens cria definições de índice para os query usados pelo produto.
Se houver WARNs de travessia do Query em error.log, crie um índice personalizado para o query. Consulte Configurando os Índices para obter mais detalhes.

Você também pode consultar um recurso adicional em Documentação do Oak.