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 dello schermo vuoto

NOTA

I controlli obbligatori elencati devono essere eseguiti dal supporto principale o dal supporto lato cliente prima di sollevare 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 uno schermo nero o a contenuti non riprodotti?

  • Controlla se l'anteprima del canale funziona.
  • Controlla se l'anteprima della visualizzazione funziona
  • Prova a registrare il lettore come estensione del browser sul tuo sistema allo stesso display e controlla se funziona.
  • Con il lettore in esecuzione sul sistema, passa a http://localhost:24502. Controlla se tutto il contenuto viene scaricato correttamente.
  • Controlla che le risorse vengano create le rappresentazioni appropriate e che venga riprodotto il rendering corretto.
  • Controlla eventuali contenuti pianificati e se i tempi sono corretti. Controlla se l'ora impostata nel lettore è corretta.
  • Inspect registra la console del lettore e controlla eventuali 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 i registri nella console di sviluppo.

2. Come risolvere il problema dello schermo grigio in AEM Screens creando un canale o una pianificazione predefinita?

Per evitare le schermate vuote o grigie nel campo, crea un canale globale predefinito o una pianificazione, assegnata a ogni visualizzazione con la priorità minima 1. Nel caso in cui qualcosa non funzioni con gli aggiornamenti dei contenuti (a causa di rete, lettore, server o replica), poiché i lettori hanno già questo contenuto memorizzato nella cache del disco, che dovrebbe essere riprodotto correttamente ed evitare gli schermi grigi.

Tutti gli altri contenuti, come canali o pianificazioni, avranno priorità maggiore di 1, quindi l’altro contenuto ha priorità e il canale globale o il contenuto della pianificazione (con priorità 1) verrà riprodotto solo come opzione di fallback.

Gestione dei canali

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

Un Canale online mostra il contenuto aggiornato in ambiente in tempo reale, mentre in Canale offline mostra il contenuto della cache.

2. Come faccio un canale online?

Seleziona il canale e passa alle proprietà del canale dalla barra delle azioni. Controlla Modalità Sviluppatore (forzare il canale ad essere online) sotto Canale scheda 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 un tipo 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 il percorso specificato.

Per riferimenti dinamici, la risoluzione si verifica una volta che il canale viene assegnato alla visualizzazione (non alla pianificazione). Il percorso di visualizzazione diventa il contesto del canale e la risoluzione si verifica come segue (priorità da più alta a quella 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 a cui si fa riferimento
  3. La posizione padre della visualizzazione ha un nodo figlio che corrisponde al nome del canale a cui si fa riferimento
  4. La posizione principale della visualizzazione ha un nodo figlio che corrisponde al nome del canale di riferimento

E così via, fino a raggiungere la cartella delle posizioni e fermarsi lì al momento (in modo da non fare riferimento a un canale che sarebbe nella cartella dei canali, per esempio, solo i canali nella sottostruttura delle posizioni).

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

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

Segui i passaggi riportati di seguito dall’editor di 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 clientlib.
  3. Fai clic sul pulsante di configurazione (l’icona a forma di chiave inglese).
  4. Passa a Configurazione offline e aggiungi il percorso alla clientlib personalizzata in Librerie lato client.

Registrazione dispositivo

1. Se scopro endpoint come richieste di onboarding e registrazione dei dispositivi, posso creare script su un gran numero di dispositivi e registrare questi dispositivi. Oltre a bloccare questo su un ramo Wi-Fi, è possibile proteggere queste richieste?

Attualmente la registrazione è possibile solo sull'istanza dell'autore. Anche se il servizio di registrazione non è autenticato, creerà solo un dispositivo in sospeso in AEM e non registrerà effettivamente il dispositivo o assegnerà alcun display.

Per registrare un dispositivo (il che significa creare un utente per il dispositivo in AEM), è comunque necessario eseguire l'autenticazione per 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 uno 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 di POST.

Si consiglia di ottenere l’ID dispositivo dalla sessione anziché come parametro. Questo eliminerebbe i registri del server, la cache del browser e così via. Attualmente non si tratta di un problema di sicurezza. Tieni presente che GET viene utilizzato semanticamente quando non vi sono modifiche di stato sul server e POST viene utilizzato quando si verifica una modifica di stato.

3. C'è un modo per rifiutare una richiesta di registrazione del dispositivo?

Non è possibile rifiutare le richieste di registrazione. Al contrario, le richieste di registrazione dovrebbero 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.

Report di monitoraggio e integrità dei dispositivi

1. Come posso risolvere il problema, se il mio lettore AEM Screens mostra la schermata vuota?

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

  • AEM non è in grado di inviare il contenuto offline
  • Il canale non ha contenuto
  • Nessuna delle risorse è pianificata per essere visualizzata al momento attuale

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

È necessario abilitare l’opzione Consenti valori vuoti per il filtro di riferimento Apache Sling. Questo è necessario per il funzionamento ottimale del protocollo di controllo tra AEM Screens Player e il server AEM Screens.

  1. Passa a Configurazione della console Web di 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 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 del server AEM Screens. Puoi provare a utilizzare l'indirizzo IP per la connessione. Per ottenere l’IP del server, utilizza: arp <server_dns_name>.

4. AMS consiglia di implementare un Android Watchdog su tutti i dispositivi? Il plugin Watchdog (Cordova) è incluso come parte dell'APK?

Un cane da guardia Android multipiattaforma che utilizza API Android pure è già una 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, verrà chiuso e riavviato l'applicazione ma non il ciclo di alimentazione.

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

5. Quali strumenti di monitoraggio remoto e di avviso (software) di terze parti sono consigliati da Adobe/AMS per il monitoraggio di ciascun dispositivo?

A seconda delle esigenze di monitoraggio e avvisi, una nuova funzione del servizio Notifiche di AEM Screens ti avvisa se un dispositivo non è stato bloccato da qualche tempo. Gli strumenti di terze parti dipenderanno dal sistema operativo, dalle sue funzionalità e dalle esigenze specifiche del cliente.

Per ulteriori informazioni su dove è possibile monitorare l'attività del dispositivo, consulta Servizio notifiche AEM Screens.

Lettore AEM Screens

1. Come installare il lettore ChromeOS come plugin del browser Chrome?

ChromeOS Player può essere installato come plugin del browser Chrome in modalità sviluppatore senza richiedere l'effettivo dispositivo chrome player. Per l'installazione, segui i passaggi seguenti:

  1. Fai clic su qui per scaricare il lettore Chrome più recente.
  2. Decomprimere e salvarlo sul disco.
  3. Apri il browser Chrome e seleziona Estensioni dal menu o direttamente passa a chrome://extensions.
  4. Accendere Modalità Sviluppatore dall'angolo in alto a destra.
  5. Fai clic su Carica non imballato dall'angolo in alto a sinistra e carica il lettore Chrome decompresso.
  6. Controlla Lettore Chrome di AEM Screens se disponibile nell’elenco delle estensioni.
  7. Apri una nuova scheda e fai clic su App dall’angolo in alto a sinistra o direttamente passare a 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. Press cese per uscire dalla modalità a schermo intero.

2. Come risolvere il problema se Screens Player non è in grado di eseguire l'autenticazione tramite l'istanza di pubblicazione con un gestore di errori personalizzato?

All'avvio di 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 da autenticare rispetto all'istanza di pubblicazione. Se nell'istanza di pubblicazione è presente un gestore di errori personalizzato, assicurati di restituire il codice di stato 404 per l'utente anonimo su /content/screens/svc.ping.json.

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

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

  1. Passa alle impostazioni del lettore Android —> Informazioni
  2. Tocca 7 volte il numero di build per abilitare Opzioni per gli sviluppatori in Impostazioni
  3. Passa a Opzioni per gli sviluppatori
  4. Abilita Resta sveglia

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

Non è disponibile una modalità finestra in Windows Player. È sempre in modalità a schermo intero.

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

Segui i passaggi seguenti per risolvere eventuali 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. Quando AEM Screens Player si avvia, richiede a /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 istanza. Se è presente un gestore di errori personalizzato nel pubblicare istanza, assicurati di restituire il codice di stato 404 per l'utente anonimo su /content/screens/svc.json o /content/screens/svc.ping.json.

  2. Controlla se la configurazione del tuo dispatcher consente queste richieste nel /filters.

    Vedi Configurazione dei filtri Screens per ulteriori dettagli.

  3. Controlla 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 norme autore o pubblicare I percorsi delle istanze e delle schermate corrispondono a sling:match e reindirizzato internamente a un percorso diverso. Risoluzione dell'url esatto in /system/console/jcrresolver aiuta a identificare se pubblicare istanza sta riscrivendo questi URL in qualsiasi altro percorso.

  5. Controlla 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: Tre archivi ContextHub definiti in /libs/screens/clientlibs/contexthub per esporre canali, dispositivi e informazioni di visualizzazione.

    Segui i passaggi seguenti per utilizzare i seguenti valori dell’archivio ContentHub:

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

    • Nel canale JS, 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 l'errore di A/P Screens?

Per disabilitare Livefyre per evitare errori di log :

  1. Disattiva il bundle Livefyre:

    • Accedi a https://&lt;host&gt;:&lt;port&gt;/system/console/bundles
    • Cerca il bundle Livefyre AEM: com.adobe.cq.social.cq-social-livefyre
    • Fai clic su Interrompi
  2. Disattiva Livefyre poller:

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

2. Come aggiungere informazioni sull'indice Oak?

AEM Screens crea definizioni di indice per le query utilizzate dal prodotto.
Se ce ne sono Avvisi di attraversamento delle query in 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 su Documentazione Oak.

3. Cosa è necessario per configurare i Manifest v3?

Per abilitare il manifesto v3, devi:

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

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

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

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

  • Modifica channel/experience fragment/page components.

  • Passa a Configurazione offline scheda .

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

4. Cosa devi fare se, dopo l'installazione dei pacchetti screens-cloud-ams-pkg-0.0.20, screens-cloud-ams-pkg-0.0.16 e dei bundle di base degli schermi, sono installati ma non attivi?

È necessario installare una versione minima di AEM 6.5 Feature Pack 8 per il funzionamento del connettore AMS. Consulta la sezione Disponibilità per ottenere la versione minima del feature pack 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 del dispositivo e anche per il targeting ContextHub.

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

  1. Accedi a http://localhost:4502/system/console/configMgr
  2. Day CQ Link Externalizer
  3. Modificare il nome host per author/publish voci come necessario

In questa pagina