Implementazione di Android Player

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.

Installazione di Android Player

Per implementare Android Player per AEM Screens, installate Android Player per AEM Screens.

Visita la pagina AEM 6.5 Player Downloads.

Impostazione dell'ambiente per AEM Screens 6.5.5 Service Pack

NOTA

È 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:

  1. Passa a Configurazione console Web Adobe Experience Manager utilizzando http://localhost:4502/system/console/configMgr.

  2. Cercare gestore autenticazione token granito Adobe.

  3. Impostate l'attributo SameSite per i cookie del token di login da Lax a None.
    immagine

  4. Fai clic su Salva.

Metodo ad hoc

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:

  1. Tenete premuto sull’angolo in alto a sinistra per aprire il pannello di amministrazione.

  2. 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.

  3. Andate al collegamento Dispositivo Registrazione dal menu delle azioni a sinistra per verificare lo stato del processo di registrazione del dispositivo.

NOTA

Se State è REGISTERED, il campo Device id verrà popolato.

Se State è UNREGISTERED, è possibile utilizzare il Token per registrare il dispositivo.

Implementazione di Android Watchdog

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.

Segnalazione di apposite app Android utilizzando le chiavi produttore

Per accedere ad alcune delle API privilegiate di Android, come PowerManager o HDMIControlServices, è necessario firmare l'app Android utilizzando le chiavi del produttore.

ATTENZIONE

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:

  1. Scarica l'app da Google Play o dalla pagina Download di AEM Screens Player

  2. Ottenete i tasti della piattaforma dal produttore per ottenere un file pk8 e un file pem

  3. Individuate lo strumento apksigner in android sdk utilizzando trova ~/Library/Android/sdk/build-tools -name "apksigner"

  4. <pathto> /apksigner sign —key platform.pk8 —cert platform.x509.pem aemscreensplayer.apk

  5. Trovare il percorso dello strumento di allineamento zip in android sdk

  6. <pathto> /zipalign -fv 4 aemscreensplayer.apk aemscreensalign.apk

  7. Installare aemscreensalign.apk utilizzando l'installazione adb nel dispositivo

Informazioni sui servizi Android Watchdog

Il servizio di controllo Android è implementato come plug-in cordova utilizzando AlarmManager.

Il diagramma seguente mostra l’implementazione del servizio di controllo:

chlimage_1-31

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).

NOTA

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).

Provisioning di massa di Android Player

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.

NOTA

Questa funzione è disponibile dal lettore Android 42.0.372.

Seguite i passaggi indicati di seguito per consentire il provisioning in blocco nel lettore Android:

  1. 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.

  2. Utilizzate un file Explorer MDM, ADB o Android Studio per rilasciare il file JSON del criterio nella cartella sdcard sul dispositivo Android.

  3. Una volta distribuito il file, utilizzate il MDM per installare l'applicazione del lettore.

  4. 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.

    NOTA

    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.

Attributi del criterio

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).

Criteri JSON di esempio

{
  "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
}
NOTA

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.

In questa pagina