Domande frequenti su AEM Screens

La sezione seguente fornisce le risposte ad alcune delle domande frequenti più frequenti relative a un progetto AEM Screens.

Problema schermo vuoto

1. Quali dovrebbero essere i passaggi per la risoluzione dei problemi di primo soccorso per qualsiasi cliente che si trova di fronte a una schermata nera o contenuti non riprodotti?

• Verifica se l’anteprima del canale funziona.
• Verifica se l’anteprima del display funziona
• Prova a registrare il lettore come estensione del browser sul sistema per lo stesso schermo e verifica se funziona.
• Con il lettore in esecuzione sul sistema, vai a http://localhost:24502. Verifica se tutto il contenuto è scaricato correttamente.
• Controlla le risorse che sono state create le rappresentazioni appropriate e che è in corso la riproduzione della rappresentazione corretta.
• Controlla la presenza di eventuali contenuti pianificati e se gli orari sono corretti. Verificare che l'ora impostata nel lettore sia corretta.
• Inspect registra la console del lettore e verifica la presenza di errori. Fai clic con il pulsante destro del mouse e controlla per visualizzare i registri della console. Se si utilizza Windows Player, premere CTRL + ALT +I per visualizzare dev console e i relativi registri.

2. Come risolvere il problema della schermata grigia in AEM Screens creando un canale o una pianificazione predefiniti?

Per evitare le schermate vuote o grigie nel campo, crea un canale o una pianificazione globale predefinita, assegnata a ogni visualizzazione con la priorità minima di 1. In caso di problemi con gli aggiornamenti dei contenuti (a causa di rete, lettore, server o replica), poiché i lettori hanno già tali contenuti memorizzati nella cache del disco, è consigliabile che vengano riprodotti correttamente ed evitare le schermate grigie.

Tutti gli altri contenuti, ad esempio i canali o le pianificazioni, avranno priorità maggiore di 1, quindi gli altri contenuti avranno priorità e i contenuti globali dei canali o delle pianificazioni (con priorità 1) verranno riprodotti solo come opzione di fallback.

Gestione dei canali

1. Qual è la differenza tra un canale online e uno offline?

Un Canale online, mostrerà il contenuto aggiornato nell'ambiente in tempo reale, mentre un Canale offline, mostra il contenuto della cache.

2. Come si crea un canale online?

Seleziona il canale e accedi alle proprietà del canale dalla barra delle azioni. Verifica Modalità sviluppatore (forza canale online) in Canale per rendere il canale online.

3. Qual è l’utilizzo del campo Ruolo canale?

Il Ruolo canale è l’astrazione del canale effettivo eseguito in modo che l’autore possa concentrarsi direttamente sull’esperienza generica. Puoi considerarlo come una sorta di tag che identifica in modo univoco il canale nel suo contesto (visualizzazione o pianificazione).

4. Come avviene la risoluzione effettiva del canale?

Per riferimenti statici, la risoluzione segue semplicemente il percorso specificato.

Per riferimenti dinamici, la risoluzione si verifica una volta che il canale è assegnato alla visualizzazione (non alla pianificazione). Il percorso di visualizzazione diventa il contesto per il canale e la risoluzione avviene come segue (priorità dalla più alta alla più bassa):

1. La visualizzazione ha un nodo figlio che corrisponde al nome del canale a cui si fa riferimento
2. La visualizzazione ha un nodo di pari livello che corrisponde al nome del canale di riferimento
3. La posizione padre della visualizzazione ha un nodo figlio che corrisponde al nome del canale di riferimento
4. La posizione padre principale della visualizzazione ha un nodo figlio che corrisponde al nome del canale di riferimento

E così via, fino a quando non raggiungi la cartella posizioni e ci fermi in questo momento (quindi non puoi fare riferimento a un canale che si troverebbe nella cartella canali, ad esempio, solo i canali nella sottostruttura posizioni ).

5. Come impostare la configurazione offline personalizzata di clientlib nel canale AEM Screens?

Quando si utilizza un codice lato client personalizzato generato clientlib in un canale AEM Screens, sono necessari i seguenti passaggi per garantire che il clientlib i file sono stati caricati correttamente nel canale (manifest.json) e conterrà il percorso del clientlib.

Segui i passaggi seguenti dall’editor canali:

1. Seleziona un canale e fai clic su Modifica dalla barra delle azioni per aprire l’editor canali.
2. Seleziona il componente in cui desideri aggiungere il componente personalizzato clientlib.
3. Fai clic sul pulsante Configura (icona a forma di chiave inglese).
4. Accedi a Configurazione offline e aggiungere il percorso alla libreria client personalizzata in Librerie lato client.

Registrazione dispositivo

1. Se rilevo endpoint quali richieste di onboarding e registrazione dei dispositivi, posso inserire nello script un numero elevato di dispositivi e registrarli. Oltre a bloccarlo su una filiale Wi-Fi, è possibile proteggere queste richieste?

Attualmente la registrazione è possibile solo sull’istanza di authoring. Anche se il servizio di registrazione non è autenticato, creerà solo un dispositivo in sospeso in AEM e non registrerà effettivamente il dispositivo né assegnerà alcuna visualizzazione.

Per registrare un dispositivo (ovvero la creazione di un utente per il dispositivo in AEM), è comunque necessario eseguire l'autenticazione in AEM e attualmente seguire manualmente la procedura guidata di registrazione per completare la registrazione. In teoria, un utente malintenzionato può creare diversi dispositivi in sospeso, ma non può registrarne nessuno senza un accesso AEM.

2. Esiste un modo per trasformare le richieste HTTP GET in HTTP POST con una qualche forma di autenticazione?

La richiesta di registrazione è una richiesta POST.

Si consiglia di ottenere l’ID dispositivo dalla sessione anziché passare come parametro. In questo modo verrebbero eliminati i registri del server, la cache del browser e così via. Attualmente non si tratta di un problema di sicurezza. Tieni presente che viene utilizzato il GET semantico quando non vi è alcuna modifica di stato sul server e POST viene utilizzato quando si verifica una modifica di stato.

3. Esiste un modo per rifiutare una richiesta di registrazione del dispositivo?

Impossibile rifiutare le richieste di registrazione. Le richieste di registrazione dovrebbero invece scadere dopo un timeout configurato in Adobe Experience Manager Web Console. Per impostazione predefinita, questo valore è impostato su un giorno e viene memorizzato in una cache di memoria.

Monitoraggio dei dispositivi e rapporti sullo stato

1. Come posso risolvere i problemi se il lettore AEM Screens mostra una schermata vuota?

Per risolvere il problema relativo alla schermata vuota, controlla che siano disponibili le seguenti possibilità:

• AEM non è in grado di inviare contenuti offline in push
• Il canale non ha alcun contenuto
• Nessuna delle risorse è programmata per essere visualizzata al momento

2. Cosa posso fare se il lettore AEM Screens non riesce a registrarsi e il suo stato viene visualizzato come Errore?

Devi abilitare il filtro Apache Sling Referrer Allow Empty (Consenti vuoto). Ciò è necessario per il funzionamento ottimale del protocollo di controllo tra AEM Screens Player e il server AEM Screens.

1. Accedi a Configurazione della console web Adobe Experience Manager
2. Controlla la allow.empty opzione.
3. Fai clic su Salva.

3. Come risolvere il problema se durante la registrazione di un lettore AEM Screens, il dispositivo mostra l’errore FAILURE e i registri della console mostrano l’errore ENAME_NOT_FOUND?

Questo problema può verificarsi se il lettore non è in grado di trovare il DNS di AEM Screens Server. Prova a utilizzare l’indirizzo IP per la connessione. Per ottenere l'IP del server, utilizzare: arp <server_dns_name>.

4. AMS consiglia di implementare un watchdog Android su tutti i dispositivi? Il plug-in Watchdog (Cordova) è incluso nell’APK?

Un watchdog Android multipiattaforma che utilizza API Android pure fa già parte dell’apk. Non è necessario alcun software aggiuntivo, ma a seconda del dispositivo utilizzato, potrebbe essere necessario rassegnare l'apk per ottenere i privilegi di sistema per un ciclo di alimentazione completo (API Powermanager). Se non viene rassegnato utilizzando i tasti del produttore, l'applicazione verrà chiusa e riavviata, ma non verrà eseguito il ciclo di alimentazione.

Per ulteriori informazioni su come implementare Android Player, consulta Implementazione di Android Player.

5. Quali strumenti di monitoraggio e avviso remoti (software) di terze parti consiglia Adobe/AMS per il monitoraggio di ciascun dispositivo?

A seconda delle esigenze di monitoraggio e degli avvisi, una nuova funzione del servizio AEM Screens Notifications notifica all’utente se un dispositivo non effettua il ping da un po’. Gli strumenti di terze parti dipenderanno dal sistema operativo in uso, dalle sue funzionalità e dalle esigenze specifiche del cliente.

Per ulteriori informazioni su dove è possibile monitorare l'attività dei dispositivi, fare riferimento a Servizio notifiche AEM Screens.

Lettore AEM Screens

1. Come installare il lettore ChromeOS come plug-in del browser Chrome?

Il lettore ChromeOS può essere installato come plug-in del browser Chrome in modalità sviluppatore senza richiedere il dispositivo effettivo del lettore Chrome. Per l'installazione, procedere come segue:

1. Clic qui per scaricare il lettore Chrome più recente.
2. Decomprimi e salva su disco.
3. Apri il browser Chrome e seleziona Estensioni dal menu o passa direttamente a chrome://extensions.
4. Accendere il Modalità sviluppatore dall'angolo superiore destro.
5. Fai clic su Carica decompresso dall’angolo in alto a sinistra e carica Chrome Player decompresso.
6. Verifica AEM Screens Chrome Player plugin se disponibile nell’elenco delle estensioni.
7. Apri una nuova scheda e fai clic su App dall'angolo in alto a sinistra, oppure naviga direttamente in chrome://apps.
8. Fai clic su AEM Screens Plug-in per avviare Chrome Player. Per impostazione predefinita, il lettore viene avviato in modalità a schermo intero. Premi esc per uscire dalla modalità a tutto schermo.

2. Come risolvere i problemi se Screens Player non è in grado di eseguire l’autenticazione tramite l’istanza Publish con un gestore degli errori personalizzato?

All’avvio di AEM Screens Player, viene inviata una richiesta a /content/screens/svc.ping.json, quando il lettore riceve un errore 404. Il lettore avvia una richiesta di autenticazione per eseguire l’autenticazione sull’istanza Publish. Se nell’istanza di pubblicazione è presente un gestore degli errori personalizzato, assicurati di restituire il codice di stato 404 per l’utente anonimo il /content/screens/svc.ping.json.

3. Come impostare lo schermo del dispositivo rimanere su in un lettore Android?

Segui i passaggi seguenti per attivare Stay Awake in su qualsiasi lettore Android:

1. Passa a Impostazioni lettore Android —> Informazioni su
2. Tocca 7 volte il numero di build per abilitare Opzioni sviluppatore in Impostazioni
3. Accedi a Opzioni sviluppatore
4. Abilita Rimani sveglio

4. Come abilitare la modalità finestra per il lettore Windows?

Nessuna modalità finestra in Windows Player. È sempre in modalità a schermo intero.

5. Come risolvere i problemi se un lettore AEM Screens invia continuamente richieste di accesso?

Segui i passaggi seguenti per risolvere i problemi relativi a un lettore AEM Screens che invia continuamente richieste a /content/screens/svc.json e /libs/granite/core/content/login.validate/j_security_check:

1. All’avvio di AEM Screens Player, questo richiede di: /content/screens/svc.json. Quando il lettore riceve un codice di stato 404 nella risposta, avvia una richiesta di autenticazione utilizzando /libs/granite/core/content/login.validate/j_security_check contro pubblicare dell'istanza. Se è presente un gestore degli errori personalizzato in pubblicare , assicurati di restituire il codice di stato 404 per l’utente anonimo il /content/screens/svc.json o /content/screens/svc.ping.json.

2. Verifica se la configurazione del dispatcher consente tali richieste nel /filters.

   Consulta Configurazione dei filtri di Screens per ulteriori dettagli.

3. Verifica se le regole di riscrittura del dispatcher stanno riscrivendo uno dei percorsi delle schermate in un percorso diverso.

4. Controlla se hai /etc/map le regole relative alla autore o pubblicare i percorsi dell’istanza e degli schermi corrispondono a sling:match e reindirizzato internamente a un percorso diverso. Risoluzione dell’URL esatto in /system/console/jcrresolver aiuta a identificare se pubblicare L’istanza sta riscrivendo questi URL in qualsiasi altro percorso.

5. Verifica se la configurazione di Apache Sling Resource Resolver Factory sta causando riscritture interne.

6. Come ottenere i dettagli della visualizzazione e del dispositivo dall’API del lettore?

È possibile ottenere i dettagli del display e del dispositivo tramite:

• un’API JS interna

• un archivio ContextHub: in sono definiti tre store ContextHub /libs/screens/clientlibs/contexthub per esporre canali, dispositivi e, visualizza informazioni.

  Per utilizzare questi valori dell’archivio ContentHub, segui i passaggi seguenti:

  • Modifica le proprietà del canale e imposta il percorso ContextHub nella scheda di personalizzazione sul valore (come indicato sopra)

  • In JS per il canale, puoi utilizzare:

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

Suggerimenti generali per la risoluzione dei problemi

1. Come disabilitare Livefyre per evitare errori di schermate A/P?

Per disabilitare Livefyre ed evitare errori di registro:

1. Disabilita bundle Livefyre:

   • Accedi a https://<host>:<port>/system/console/bundles
   • Cerca il bundle AEM Livefyre: com.adobe.cq.social.cq-social-livefyre
   • Clic Interrompi

2. Disabilita poller Livefyre:

   • In CRXDE Lite, passa a /etc/importers/polling/livefyre-poller/jcr:content
   • Aggiungi una nuova proprietà abilitato tipo Booleano
   • Imposta proprietà enabled a false

2. Come aggiungere le informazioni dell’indice Oak?

AEM Screens crea definizioni di indice per le query utilizzate dal prodotto.
Se sono presenti Avvisi di attraversamento query nel error.log, crea un indice personalizzato per la query. Fai riferimento a Configurazione degli indici per ulteriori dettagli.

Puoi anche fare riferimento a una risorsa aggiuntiva in Documentazione di Oak.

3. Cosa è necessario per configurare i manifesti v3?

Per abilitare il manifesto v3, è necessario:

• Aggiorna Dispatcher.
  Consulta Configurazione di Dispatcher per la versione v3 del manifesto per ulteriori dettagli.

• Aggiorna componente personalizzato.
  Consulta Modello per gestori personalizzati per ulteriori dettagli.

• Disattiva ContentSync in /system/console/configMgr/configMgr/com.adobe.cq.screens.offlinecontent.impl.ContentSyncCacheFeatureFlag.

• Abilitare SmartSync in /system/console/configMgr/com.adobe.cq.screens.offlinecontent.impl.OfflineContentServiceImpl.

• Modifica channel/experience fragment/page components.

• Accedi a Configurazione offline scheda.

• Invio clientlibs e cartelle per i file statici che devono essere aggiunti al manifesto.

4. Cosa devi fare se, dopo il pacchetto screens-cloud-ams-pkg-0.0.20, screens-cloud-ams-pkg-0.0.16 e i bundle di base screens sono installati ma non attivi?

Affinché il connettore AMS funzioni, è necessario installare una versione minima di AEM 6.5 Feature Pack 8. Consulta la Disponibilità per ottenere la versione minima del feature pack Screens.

5. Come configurare il servizio CQ Link Externalizer in Screens?

Il servizio viene utilizzato per definire il nome host pubblico per le istanze di authoring e pubblicazione e i valori vengono quindi utilizzati per aggiornare gli URL del server dispositivo e anche per il targeting ContextHub.

Il servizio CQ Link Externalizer in Screens può essere configurato tramite:

1. Accedi a http://localhost:4502/system/console/configMgr
2. Day CQ Link Externalizer
3. Modifica il nome host per author/publish voci in base alle esigenze