DocumentazioneAEMGuida di AEM Screens

Domande frequenti su AEM Screens aem-screens-faqs

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Intermedio
  • Sviluppatore

Questo argomento fornisce le risposte alle domande frequenti più frequenti relative a un progetto AEM Screens.

Problema schermo vuoto blank-screen

NOTE
L’elenco dei controlli obbligatori che il supporto principale o il supporto lato cliente devono provare prima di segnalare un problema.

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? troubleshooting-blank-screen

  • 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, passa a http://localhost:24502. Verifica se tutto il contenuto è scaricato correttamente.
  • Controlla le risorse in modo da poter creare le rappresentazioni appropriate e riprodurre quella 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 la console di sviluppo e i 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. Nel caso in cui si verifichi un errore con gli aggiornamenti del contenuto, perché il contenuto è già memorizzato nella cache del disco dei lettori. Dovrebbe funzionare correttamente ed evitare le schermate grigie.

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

Gestione dei canali channel-management

1. Qual è la differenza tra un canale online e uno offline? what-is-the-difference-between-an-online-and-an-offline-channel

Un canale online mostra il contenuto aggiornato nell'ambiente in tempo reale, mentre un canale offline mostra il contenuto nella cache.

2. Come si crea un canale online? how-do-i-make-a-channel-online

Fai clic sul canale e accedi alle proprietà del canale dalla barra delle azioni. Seleziona Modalità sviluppatore (forza canale online) nella scheda Canale per rendere il canale online.

3. Qual è l’utilizzo del campo Ruolo canale? what-is-the-use-of-the-channel-role-field

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? how-does-actual-channel-resolution-happen

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 raggiungere la cartella posizioni. Fermarsi qui al momento (quindi non è possibile fare riferimento a un canale che si troverebbe nella cartella dei canali, ad esempio, solo i canali nella sottostruttura della posizione).

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

Quando si utilizza un codice personalizzato generato lato client clientlib in un canale AEM Screens, sono necessari i passaggi seguenti. I passaggi garantiscono che i file clientlib siano caricati correttamente nel canale (manifest.json) e contengano il percorso di clientlib.

Segui i passaggi seguenti dall’editor canali:

  1. Fai clic su un canale, quindi fai clic su Modifica nella barra delle azioni.
  2. Fare clic sul componente in cui si desidera aggiungere clientlib personalizzato.
  3. Fai clic sul pulsante Configura (icona a forma di chiave inglese).
  4. Passa alla scheda Configurazione offline e aggiungi il percorso alla libreria client personalizzata in Librerie lato client.

Registrazione dispositivo device-registration

1. Se rilevo endpoint quali richieste di onboarding e registrazione dei dispositivi, posso inserire nello script molti dispositivi e registrarli. Oltre a bloccarlo su una filiale Wi-Fi, è possibile proteggere queste richieste? if-i-discover-endpoints-such-as-requests-for-device-onboarding-and-registration-i-can-script-a-large-number-of-devices-and-register-these-devices-besides-locking-this-to-a-branch-wi-fi-is-it-possible-to-secure-these-requests

Attualmente la registrazione è possibile solo sull’istanza di authoring. Sebbene il servizio di registrazione non sia autenticato, crea solo un dispositivo in sospeso nell’AEM e non registra effettivamente il dispositivo né assegna alcun display.

Per registrare un dispositivo (creando un utente per il dispositivo in AEM), eseguire l'autenticazione in AEM e 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 se non ha un accesso AEM.

2. Esiste un modo per trasformare le richieste HTTP GET in HTTP POST con una qualche forma di autenticazione? is-there-a-way-to-transform-http-get-requests-into-http-post-with-some-form-of-authentication

La richiesta di registrazione è una richiesta POST.

Si consiglia di ottenere l’ID dispositivo dalla sessione, anziché passare come parametro. In questo modo si eliminerebbero i registri del server, la cache del browser e così via. Non è un problema di sicurezza. Semanticamente. GET viene utilizzato quando non vi è alcuna modifica di stato sul server e POST viene utilizzato quando si è verificata una modifica di stato.

3. Esiste un modo per rifiutare una richiesta di registrazione del dispositivo? is-there-a-way-to-decline-a-device-registration-request

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 device-monitoring-and-health-reports

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

Cerca le seguenti possibilità per risolvere il problema della schermata vuota:

  • 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 AEM Screens Player non riesce a registrarsi e il suo stato viene visualizzato come Errore?

Abilita il filtro Apache Sling Referrer Allow Empty. Necessario per il funzionamento ottimale del protocollo di controllo tra AEM Screens Player e il server AEM Screens.

  1. Passa a Configurazione console Web Adobe Experience Manager
  2. Controlla l'opzione allow.empty.
  3. Fai clic su Salva.

3. Come risolvere il problema se durante la registrazione di un lettore AEM Screens, il dispositivo mostra FAILURE e i registri della console mostrano un 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 <nome_server_dns>.

4. AMS consiglia di implementare un watchdog Android™ su tutti i dispositivi? Il plug-in Watchdog (Cordova) è incluso nell’APK? does-ams-recommend-implementing-an-android-watchdog-on-all-devices-is-the-watchdog-cordova-plugin-included-as-part-of-the-apk

Un watchdog multipiattaforma Android™ che utilizza API Android™ pure fa già parte dell’apk. Non sono necessari software aggiuntivi. Tuttavia, a seconda del dispositivo utilizzato, è possibile rassegnare l'apk per ottenere i privilegi di sistema per un ciclo di alimentazione completo (Powermanager api), se necessario. Se non viene rassegnato utilizzando i tasti del produttore, l'applicazione viene chiusa e riavviata, ma non viene eseguita l'accensione.

Per ulteriori informazioni su come implementare Android™ Player, vedere 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? what-third-party-remote-monitoring-and-alerting-tools-software-does-adobe-ams-recommend-for-monitoring-each-device

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 dipendono dal sistema operativo in uso, dalle sue funzionalità e dalle esigenze specifiche del cliente.

Per ulteriori informazioni su dove è possibile monitorare l'attività del dispositivo, vedere Servizio notifiche di schermata AEM.

Lettore AEM Screens

1. Come installare il lettore ChromeOS come plug-in del browser Chrome? how-to-install-chromeos-player-as-chrome-browser-plugin

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

  1. Fai clic qui per scaricare il lettore Chrome più recente.
  2. Decomprimi e salva su disco.
  3. Apri il browser Chrome e fai clic su Estensioni dal menu o passa direttamente a chrome://extensions.
  4. Attiva la modalità sviluppatore dall'angolo superiore destro.
  5. Fai clic su Carica decompresso dall'angolo in alto a sinistra e carica Chrome Player decompresso.
  6. Se disponibile nell'elenco delle estensioni, controllare il plug-in AEM Screens Chrome Player.
  7. Apri una nuova scheda e fai clic sull'icona App in alto a sinistra oppure passa direttamente a chrome://apps.
  8. Fare clic sul plug-in AEM Screens. Per impostazione predefinita, il lettore viene avviato in modalità a schermo intero. Premere Esc per uscire dalla modalità a schermo intero.

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

All'avvio, AEM Screens Player invia 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 nell’istanza di pubblicazione. Se nell'istanza di pubblicazione è presente un gestore degli errori personalizzato, assicurarsi di restituire il codice di stato 404 per un utente anonimo in /content/screens/svc.ping.json.

3. Come si imposta la visualizzazione del dispositivo in un lettore Android™? how-to-set-the-device-screen-stay-on-in-an-android-player

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

  1. Passa a Impostazioni lettore Android™ > Informazioni.
  2. Tocca sette volte il numero di build in modo da poter abilitare Opzioni sviluppatore in Impostazioni.
  3. Passa a Opzioni sviluppatore.
  4. Abilita Rimani sveglio.

4. Come attivare la modalità finestra per Windows Player? enable-player

In Windows Player non è disponibile alcuna modalità finestra. È sempre in modalità a schermo intero.

5. Come risolvere i problemi se AEM Screens Player 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, AEM Screens Player invia una richiesta a /content/screens/svc.json. Quando il lettore ottiene un codice di stato 404 nella risposta, avvia una richiesta di autenticazione utilizzando /libs/granite/core/content/login.validate/j_security_check rispetto all'istanza publish. Se nell'istanza publish è presente un gestore degli errori personalizzato, assicurarsi di restituire il codice di stato 404 per l'utente anonimo in /content/screens/svc.json o /content/screens/svc.ping.json.

  2. Verificare che la configurazione del Dispatcher consenta queste richieste in /filters.

    Per ulteriori dettagli, vedere Configurazione dei filtri di Screens.

  3. Verifica se le regole di riscrittura di Dispatcher stanno riscrivendo uno qualsiasi dei percorsi dello schermo in un percorso diverso.

  4. Controlla se ci sono /etc/map regole nell'istanza author o publish e i percorsi delle schermate corrispondono a sling:match e vengono reindirizzati internamente a un percorso diverso. La risoluzione dell'URL esatto in /system/console/jcrresolver consente di identificare se l'istanza publish 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 /libs/screens/clientlibs/contexthub sono definiti tre archivi ContextHub per esporre canali, dispositivi e informazioni di visualizzazione.

    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:

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

Suggerimenti generali per la risoluzione dei problemi general-troubleshooting-tips

1. Come si disabilita Livefyre per evitare l’errore A/P Screens?

Disattiva Livefyre per evitare errori di registro, effettuando le seguenti operazioni.

  1. Disabilita bundle Livefyre:

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

  2. Disabilita poller Livefyre:

    • In CRXDE Lite, passa a /etc/importers/polling/livefyre-poller/jcr:content.
    • Aggiungi una proprietà enabled di tipo Boolean.
    • Impostare Proprietà abilitata su false.

2. Come si aggiungono le informazioni dell’indice Oak? add-oak-index-info

AEM Screens crea definizioni di indice per le query utilizzate dal prodotto.
Se in error.log sono presenti avvisi di attraversamento query, creare un indice personalizzato per la query. Per ulteriori dettagli, vedere Configurazione degli indici.

È inoltre possibile visualizzare una risorsa aggiuntiva nella documentazione di Oak.

3. Cosa è necessario per configurare i manifesti v3? configure-v3

Per abilitare il manifesto v3, effettuare le seguenti operazioni:

  • Aggiornare Dispatcher.
    Per ulteriori dettagli, vedere Configurazione di Dispatcher per la versione del manifesto v3.

  • Aggiorna componente personalizzato.
    Per ulteriori dettagli, vedi Modello per gestori personalizzati.

  • Disabilita 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.

  • Passa alla scheda Configurazione offline.

  • Immettere clientlibs e le 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?

Installa una versione minima del Feature Pack 8 di AEM 6.5 affinché il connettore AMS funzioni. Consulta Disponibilità per ottenere la versione minima del Feature Pack di AEM 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 nel modo seguente:

  1. Passa a http://localhost:4502/system/console/configMgr
  2. Day CQ Link Externalizer
  3. Modifica il nome host per le voci author/publish in base alle esigenze
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053