Perguntas frequentes do AEM Screens

A seção a seguir fornece respostas para algumas das perguntas frequentes mais frequentes relacionadas a um projeto do 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 enfrente uma tela preta ou não reproduz conteúdo?

• Verifique se a visualização do canal está funcionando.
• Verifique se a visualização de exibição está funcionando
• Tente registrar o reprodutor como uma extensão de navegador em seu sistema para a mesma exibição e verificar 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á conteúdo programado e se os horários estão corretos. Verifique se o tempo configurado no reprodutor 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 logs do console. Se estiver usando o windows player, pressione CTRL + ALT +I para ativar o console dev para visualizar os logs.

2. Como resolver o problema de tela cinza no AEM Screens criando um canal ou cronograma padrão?

Para evitar as telas em branco ou em cinza no campo , crie um canal ou programação global padrão, atribuído a cada exibição com a menor prioridade 1. No caso, algo dá errado com atualizações de conteúdo (devido a rede, reprodutor, servidor ou replicação), já que os players têm esse conteúdo já armazenado em cache no disco, que deve ser reproduzido corretamente e evitar as telas cinza.

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

Gerenciamento de canal

1. Qual é a diferença entre um canal online e offline?

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 criar um canal online?

Selecione o canal e navegue até as propriedades do canal na barra de ações. Marque o Modo do desenvolvedor (forçar o canal a ficar online) na guia Canal para tornar 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 se concentrar diretamente na experiência genérica. Pense nele como um tipo de tag que identifica exclusivamente o canal em seu contexto (exibição ou programação).

4. Como a resolução de canal real 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 acontece da seguinte maneira (da prioridade mais alta à 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é atingir a pasta de localizações e parar lá no momento (de modo que não seja possível fazer referência a um canal que estaria na pasta de canais, por exemplo, apenas canais na subárvore de localizações).

Registro do dispositivo

1. Se eu descobrir endpoints como solicitações de integração e registro de dispositivos, posso criar scripts para um grande número de dispositivos e registrar esses dispositivos. Além de bloquear isso em 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 ou 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 registrar nenhum sem um logon AEM.

2. Existe uma maneira de transformar solicitações HTTP GET em HTTP POST 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 logs do servidor, o cache do navegador e assim por diante. No momento, não é 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. Existe 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 no 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 de dispositivo

1. Como soluciono o problema, se o meu reprodutor AEM Screens exibir tela em branco?

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

• O AEM não pode enviar o conteúdo offline
• O canal não tem conteúdo
• Nenhum dos ativos está programado para ser exibido no momento atual

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

Você precisa ativar o Filtro de referenciador do 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 Console Web do Adobe Experience Manager
2. Marque a opção allow.empty.
3. Clique em Salvar.

3. Como solucionar problemas se, durante o registro de um reprodutor do AEM Screens, o dispositivo mostrar FAILURE e os registros do console exibirem o erro ENAME_NOT_FOUND?

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

4. O AMS recomenda a implementação de um Android Watchdog em todos os dispositivos? O plug-in Watchdog (Cordova) é incluído como parte do APK?

Um observatório Android de várias plataformas usando APIs puras do Android 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 completo de energia (api do Powermanager). Se não for demitido usando as teclas do fabricante, o aplicativo será fechado e reiniciado, mas não o ciclo de alimentação.

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

5. Quais ferramentas de monitoramento remoto e alerta (software) de terceiros 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 de Notificações da AEM Screens notifica você se um dispositivo não tiver pingado por algum tempo. As ferramentas de terceiros dependerão do seu sistema operacional (SO), de seus 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 player do ChromeOS como plug-in do navegador Chrome?

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

1. Clique aqui para baixar o Player mais recente do Chrome.
2. Descompacte-o e salve-o no disco.
3. Abra o navegador Chrome e selecione Extensões no menu ou navegue diretamente para chrome://extensions.
4. Ative o Modo de desenvolvedor a partir do canto superior direito.
5. Clique em Carregar descompactado do 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 Apps no canto superior esquerdo ou navegue diretamente para chrome://apps.
8. Clique no plug-in AEM Screens para iniciar o Chrome Player. Por padrão, o reprodutor é iniciado no modo de tela cheia. Pressione esc para sair do modo de tela cheia.

2. Como solucionar problemas se o reprodutor do Screens não conseguir se autenticar por meio da instância de publicação com o manipulador de erros personalizado?

Quando o reprodutor do AEM Screens é iniciado, ele faz uma solicitação para /content/screens/svc.ping.json, quando o reprodutor recebe um erro 404. O reprodutor inicia uma solicitação de autenticação para autenticação na instância de publicação. Se houver um manipulador de erro personalizado na instância de publicação, retorne o código de status 404 para 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 e ativar a opção Permanecer ativo 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 ativar Opções do Desenvolvedor em Configurações
3. Navegue até Opções do Desenvolvedor
4. Ativar Estar Awake

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

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

5. Como solucionar problemas se um reprodutor do AEM Screens enviar solicitações de logon continuamente?

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

1. Quando o reprodutor do AEM Screens é iniciado, ele solicita /content/screens/svc.json. Quando o reprodutor 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 na instância publish. Se houver um manipulador de erro personalizado na instância publish, retorne o código de status 404 para 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 Configuração de filtros do Screens para obter mais detalhes.

3. Verifique se as regras de reescrita do dispatcher estão reescrevendo qualquer um dos caminhos de tela para um caminho diferente.

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

5. Verifique se a configuração da Fábrica do Resolvedor de Recursos do Apache Sling está causando regravações internas.

6. Como obter os detalhes do monitor e do dispositivo da API do reprodutor?

Você pode obter os detalhes da exibição e do dispositivo por meio de:

• uma API JS interna

• um armazenamento do ContextHub: Três armazenamentos do ContextHub são definidos no /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 de personalização como o valor (como mencionado acima)

  • No JS do canal, 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 telas A/P?

Para desativar o Livefyre para evitar erros de log:

1. Desative o pacote Livefyre:

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

2. Desative o Livefyre poler:

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

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

O AEM Screens cria definições de índice para as consultas usadas pelo produto.
Se houver AVISOs de passagem de consulta no error.log, crie um índice personalizado para sua consulta. Consulte Configuração de Índices para obter mais detalhes.

Também é possível consultar um recurso adicional em Documentação do Oak.