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

OBSERVAÇÃO

As verificações obrigatórias listadas que devem ser tentadas pelo suporte principal ou pelo suporte do lado do cliente antes de levantar um problema.

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 reprodutor 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 exibir o console dev para exibir 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. Verificar Modo Desenvolvedor (forçar o canal a ficar online) under 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).

5. Como configurar a configuração offline personalizada clientlib no Canal AEM Screens?

Ao usar um código personalizado do lado do cliente incorporado clientlib em um canal AEM Screens, as etapas a seguir são necessárias para garantir que a variável clientlib os arquivos são carregados com êxito no canal (manifest.json) e conterão o caminho da variável clientlib.

Siga as etapas abaixo no editor de canais:

  1. Selecione um canal e clique em Editar na barra de ações para abrir o editor de canais.
  2. Selecione o componente ao qual deseja adicionar o clientlib.
  3. Clique no botão configurar (o ícone de chave inglesa).
  4. Navegue até o Configuração offline e adicione o caminho à sua clientlib personalizada em Bibliotecas do lado do cliente.

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 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 de dispositivos

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. Navegar para Configuração do Console da Web do Adobe Experience Manager
  2. Verifique a allow.empty opção.
  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. 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 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 Serviço de notificações da AEM Screens.

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 em here para baixar o Player do Chrome mais recente.
  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 do canto superior direito.
  5. Clique em Carregar desempacotado no canto superior esquerdo e carregar o Chrome Player descompactado.
  6. Verificar Player do AEM Screens Chrome plug-in se estiver disponível na lista de extensões.
  7. Abra uma nova guia e clique no botão Aplicativos ícone 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 reprodutor é iniciado no modo de tela cheia. Press 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 erros 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 Android Player —> Sobre
  2. Toque 7 vezes no número de compilação para ativar Opções do desenvolvedor em Configurações
  3. Navegar para Opções do desenvolvedor
  4. Habilitar Fique acordado

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 solicitações continuamente para o /content/screens/svc.json e /libs/granite/core/content/login.validate/j_security_check:

  1. Quando o reprodutor do AEM Screens é iniciado, ele solicita para /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 contra publicar instância. Se houver um manipulador de erro personalizado na publicar , certifique-se de retornar 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 dos 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ê /etc/map as regras autor ou publicar os caminhos de instância e tela são correspondidos a sling:match e internamente redirecionado para um caminho diferente. Resolver o url exato em /system/console/jcrresolver ajuda a identificar se a variável publicar A instância do 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 em /libs/screens/clientlibs/contexthub para expor canais, dispositivo 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://&lt;host&gt;:&lt;port&gt;/system/console/bundles
    • Procure pelo pacote AEM Livefyre: com.adobe.cq.social.cq-social-livefyre
    • Clique em Stop
  2. Desative o Livefyre poler:

    • No CRXDE Lite, navegue até /etc/importers/polling/livefyre-poller/jcr:content
    • Adicionar uma nova propriedade ativado type Booleano
    • Definir 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 algum ADVERTÊNCIAS DE travessia de query no error.log, crie um índice personalizado para o seu query. Consulte Configuração dos índices para obter mais detalhes.

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

3. O que é necessário para configurar Manifestações v3?

Para habilitar o Manifesto v3, você deve:

  • Atualize o Dispatcher.
    Consulte Configurar o Dispatcher para a Versão de Manifesto v3 para obter mais detalhes.

  • Atualizar componente personalizado.
    Consulte Modelo para Manipuladores Personalizados para obter mais detalhes.

  • Desative o ContentSync em /system/console/configMgr/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag.

  • Ativar o SmartSync em /system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.OfflineContentServiceImpl.

  • Editar channel/experience fragment/page components.

  • Navegue até o Configuração offline guia .

  • Enter clientlibs e pastas para arquivos estáticos que precisam ser adicionados ao manifesto.

4. O que você deve fazer se, após o pacote screens-cloud-ams-pkg-0.0.20, screens-cloud-ams-pkg-0.0.16 e os pacotes principais de telas estiverem instalados, mas não ativos?

Você deve instalar uma versão mínima do AEM 6.5 Feature Pack 8 para que o conector AMS funcione. Consulte a Disponibilidade para obter a versão mínima do pacote de recursos do Screens.

O serviço é usado para definir o nome do host público para as instâncias de autor e publicação, e os valores são usados para atualizar os URLs do servidor de dispositivos e também para o direcionamento do ContextHub.

O serviço CQ Link Externalizer no Screens pode ser configurado via:

  1. Vá até http://localhost:4502/system/console/configMgr
  2. Externalizador de links CQ do dia
  3. Altere o nome de host para a author/publish entradas, conforme necessário

Nesta página