Questa sezione descrive la configurazione del lettore Android. Fornisce informazioni sul file di configurazione e sulle opzioni disponibili e consigli sulle impostazioni da utilizzare per lo sviluppo e il test.
Inoltre, Watchdog è una soluzione per recuperare il lettore da arresti anomali. Un'applicazione deve registrarsi presso il servizio di controllo e inviare periodicamente messaggi al servizio che è attivo. Nel caso in cui il servizio di controllo non riceva un messaggio keep-alive entro un tempo stabilito, il servizio tenta di riavviare il dispositivo per un ripristino pulito (se dispone dei privilegi sufficienti) o di riavviare l'applicazione.
Per implementare Android Player per AEM Screens, installate Android Player per AEM Screens.
Visita la pagina AEM 6.5 Player Downloads.
È necessario configurare un ambiente per il lettore Android se si utilizza AEM Screens 6.5.5 Service Pack.
Impostate l'attributo SameSite per i cookie di token di login da Lax a None da Configurazione della console Web di Adobe Experience Manager su tutte AEM istanze di creazione e pubblicazione.
Effettua le seguenti operazioni:
Passa a Configurazione console Web Adobe Experience Manager utilizzando http://localhost:4502/system/console/configMgr
.
Cercare gestore autenticazione token granito Adobe.
Impostate l'attributo SameSite per i cookie del token di login da Lax a None.
Fai clic su Salva.
Il metodo Ad-Hoc consente di installare la versione più recente di Android Player (.exe). Visita la pagina AEM 6.5 Player Downloads.
Una volta scaricata l’applicazione, seguite i passaggi del lettore per completare l’installazione ad hoc:
Tenete premuto sull’angolo in alto a sinistra per aprire il pannello di amministrazione.
Andate a Configuration dal menu delle azioni a sinistra e immettete la posizione (indirizzo) dell'istanza AEM a cui desiderate connettervi e fate clic su Save.
Andate al collegamento Dispositivo Registrazione dal menu delle azioni a sinistra per verificare lo stato del processo di registrazione del dispositivo.
Se State è REGISTERED, il campo Device id verrà popolato.
Se State è UNREGISTERED, è possibile utilizzare il Token per registrare il dispositivo.
A causa dell'architettura di Android, il riavvio del dispositivo richiede che l'applicazione disponga dei privilegi di sistema. A tal fine, è necessario firmare l'apk utilizzando i tasti di firma del produttore. In caso contrario, watchdog riavvierà l'applicazione del lettore e non riavvierà il dispositivo.
Per accedere ad alcune delle API privilegiate di Android, come PowerManager o HDMIControlServices, è necessario firmare l'app Android utilizzando le chiavi del produttore.
Prerequisiti:
Prima di eseguire i seguenti passaggi, devi installare l’SDK Android.
Seguite i passaggi indicati di seguito per firmare il disco Android utilizzando i tasti del produttore:
Scarica l'app da Google Play o dalla pagina Download di AEM Screens Player
Ottenete i tasti della piattaforma dal produttore per ottenere un file pk8 e un file pem
Individuate lo strumento apksigner in android sdk utilizzando trova ~/Library/Android/sdk/build-tools -name "apksigner"
<pathto> /apksigner sign —key platform.pk8 —cert platform.x509.pem aemscreensplayer.apk
Trovare il percorso dello strumento di allineamento zip in android sdk
<pathto> /zipalign -fv 4 aemscreensplayer.apk aemscreensalign.apk
Installare aemscreensalign.apk utilizzando l'installazione adb nel dispositivo
Il servizio di controllo Android è implementato come plug-in cordova utilizzando AlarmManager.
Il diagramma seguente mostra l’implementazione del servizio di controllo:
1. Inizializzazione Al momento dell'inizializzazione del plug-in cordova, le autorizzazioni vengono verificate per verificare se disponiamo dei privilegi di sistema e quindi dell'autorizzazione Riavvia. Se questi due criteri vengono soddisfatti, viene creato un Intento in sospeso per il riavvio. In caso contrario viene creato un Intento in sospeso per riavviare l'applicazione (in base all'attività di avvio).
2. Tenere il timer attivo Per attivare un evento ogni 15 secondi viene utilizzato un timer di conservazione in vita. In questo caso, è necessario annullare l'intento in sospeso esistente (per riavviare o riavviare l'app) e registrare un nuovo intento in sospeso per gli stessi 60 secondi in futuro (in sostanza, posticipare il riavvio).
In Android, l' AlarmManager viene utilizzato per registrare gli pendingIntents che possono essere eseguiti anche se l'app si è bloccata e la relativa consegna dell'allarme non è esatta dall'API 19 (Kitkat). Mantenere una certa spaziatura tra l'intervallo del timer e l'allarme AlarmManager pendingIntent.
3. Arresto anomalo dell'applicazione In caso di arresto anomalo, l'intento in sospeso per il riavvio registrato con AlarmManager non viene più reimpostato ed esegue quindi un riavvio o riavvio dell'app (a seconda delle autorizzazioni disponibili al momento dell'inizializzazione del plug-in cordova).
Quando si distribuisce il lettore Android in massa, è necessario fornire al lettore un'istanza AEM e configurare altre proprietà senza immettere manualmente quelle nell'interfaccia utente di amministrazione.
Questa funzione è disponibile dal lettore Android 42.0.372.
Seguite i passaggi indicati di seguito per consentire il provisioning in blocco nel lettore Android:
Create un file JSON di configurazione con il nome player-config.default.json
.
Fare riferimento a un esempio di criteri JSON e a una tabella che descrive l'uso dei vari attributi del criterio.
Utilizzate un file Explorer MDM, ADB o Android Studio per rilasciare il file JSON del criterio nella cartella sdcard sul dispositivo Android.
Una volta distribuito il file, utilizzate il MDM per installare l'applicazione del lettore.
Quando l'applicazione del lettore viene avviata, leggerà questo file di configurazione e indicherà il server AEM applicabile, dove può essere registrato e successivamente controllato.
Questo file è di sola lettura al primo avvio dell'applicazione e non può essere utilizzato per le configurazioni successive. Se il lettore viene avviato prima che il file di configurazione venga eliminato, disinstallate e reinstallate l'applicazione sul dispositivo.
La tabella seguente riassume gli attributi del criterio con un JSON di esempio per riferimento:
Nome criterio | Scopo |
---|---|
server | URL del server Adobe Experience Manager. |
risoluzione | La risoluzione del dispositivo. |
RestartSchedule | La pianificazione del riavvio si applica a tutte le piattaforme. |
enableAdminUI | Abilita l’interfaccia utente amministratore per configurare il dispositivo sul sito. Impostare su false una volta che è completamente configurato e in produzione. |
enableOSD | Abilitare l'interfaccia utente dello switcher di canale per consentire agli utenti di cambiare canale sul dispositivo. Considerare l'impostazione su false una volta che è completamente configurato e in produzione. |
enableActivityUI | Consente di visualizzare l'avanzamento delle attività quali il download e la sincronizzazione. Abilitate per la risoluzione dei problemi e disattivate una volta configurato completamente e in produzione. |
enableNativeVideo | Abilitate l’utilizzo dell’accelerazione hardware nativa per la riproduzione video (solo Android). |
{
"server": "https://author-screensdemo.adobecqms.net",
"device": "",
"user": "",
"password": "",
"resolution": "auto",
"rebootSchedule": "at 4:00 am",
"maxNumberOfLogFilesToKeep": 10,
"logLevel": 3,
"enableAdminUI": true,
"enableOSD": true,
"enableActivityUI": false,
"enableNativeVideo": false,
"enableAutoScreenshot": false,
"cloudMode": false,
"cloudUrl": "https://screens.adobeioruntime.net",
"cloudToken": "",
"enableDeveloperMode": true
}
Tutti i dispositivi Android dispongono di una cartella sdcard indipendentemente dal fatto che sia inserita o meno una sdcard effettiva. Il file distribuito deve trovarsi allo stesso livello della cartella Download. Alcuni MDM, come Samsung Knox, possono fare riferimento a questa cartella sdcard come Archiviazione interna.