Configurazione Android set-up-android
Scopri come configurare Streaming Media Analytics per dispositivi Android.
Prerequisiti
-
Ottenere parametri di configurazione validi per Media SDK
Questi parametri possono essere ottenuti da un rappresentante di Adobe dopo la configurazione dell’account di analisi. -
Implementare ADBMobile per Android nella tua applicazione
Per ulteriori informazioni sull’SDK per dispositivi mobili di Adobe, consulta SDK 4.x per Android per le soluzioni Experience Cloud. -
Fornisci le seguenti funzionalità nel lettore multimediale:
- API per abbonarsi agli eventi del lettore: Media SDK richiede di chiamare un set di API semplici quando si verificano eventi nel lettore.
- API che fornisce informazioni sul lettore - Queste informazioni includono dettagli quali il nome del supporto e la posizione della testina di riproduzione.
Implementazione SDK
-
Aggiungi il Media SDK scaricato al progetto.
-
Espandi il file zip Android (ad es.
MediaSDK-android-v2.*.zip
). -
Verifica che il file
MediaSDK.jar
esista nella directorylibs/
. -
Aggiungi la libreria al progetto.
IDEA IntelliJ:
-
Fai clic con il pulsante destro del mouse sul progetto nel pannello Project navigation.
-
Seleziona Open Module Settings.
-
Sotto Project Settings, seleziona Libraries.
-
Fai clic su + per aggiungere una nuova libreria.
-
Seleziona Java e naviga fino al file
MediaSDK.jar
. -
Seleziona i moduli nei quali intendi usare la libreria mobile.
-
Fai clic su Apply, quindi su OK per chiudere la finestra Impostazioni modulo.
Eclipse:
-
Nell’IDE Eclipse, fai clic con il pulsante destro del mouse sul nome del progetto.
-
Fai clic su Build Path > Add External Archives.
-
Seleziona
MediaSDK.jar
. -
Fai clic su Open.
-
Fai nuovamente clic con il pulsante destro del mouse sul progetto e quindi su Build Path > Configure Build Path.
-
Fai clic sulle schede Order e Export.
-
Assicurati che il file
MediaSDK.jar
sia selezionato.
-
-
-
Importa la libreria.
code language-java import com.adobe.primetime.va.simple.MediaHeartbeat; import com.adobe.primetime.va.simple.MediaHeartbeat.MediaHeartbeatDelegate; import com.adobe.primetime.va.simple.MediaHeartbeatConfig; import com.adobe.primetime.va.simple.MediaObject;
-
Crea l’istanza
MediaHeartbeatConfig
.Esempio di inizializzazione
MediaHeartbeatConfig
:code language-java // Media Heartbeat Initialization config.trackingServer = _<SAMPLE_HEARTBEAT_TRACKING_SERVER>_; config.channel = <SAMPLE_HEARTBEAT_CHANNEL>; config.appVersion = <SAMPLE_HEARTBEAT_SDK_VERSION>; config.ovp = <SAMPLE_HEARTBEAT_OVP_NAME>; config.playerName = <SAMPLE_PLAYER_NAME>; config.ssl = <true/false>; config.debugLogging = <true/false>;
-
Implementa l’interfaccia
MediaHeartbeatDelegate
.code language-java public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
code language-java // Replace <bitrate>, <startupTime>, <fps>, and // <droppeFrames> with the current playback QoS values. @Override public MediaObject getQoSObject() { return MediaHeartbeat.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>); } //Replace <currentPlaybackTime> with the video player current playback time @Override public Double getCurrentPlaybackTime() { return <currentPlaybackTime>; }
-
Crea l’istanza
MediaHeartbeat
.Utilizza le istanze
MediaHeartbeatConfig
eMediaHertbeatDelegate
per creare laMediaHeartbeat
.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT Assicurati che la tua istanza MediaHeartbeat
sia accessibile e non venga deallocata fino alla fine della sessione. Questa istanza verrà utilizzata per tutti gli eventi di tracciamento seguenti.
Aggiunta di autorizzazioni app
L’app che utilizza Media SDK richiede le seguenti autorizzazioni per inviare dati nelle chiamate di tracciamento:
INTERNET
ACCESS_NETWORK_STATE
Per aggiungere queste autorizzazioni, aggiungi le seguenti righe al file AndroidManifest.xml
, che si trova nella directory di progetto dell’applicazione:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Migrazione dalla versione 1.x alla versione 2.x in Android
Nelle versioni 2.x, tutti i metodi pubblici sono consolidati in com.adobe.primetime.va.simple.MediaHeartbeat
per semplificare lo sviluppo. Inoltre, tutte le configurazioni sono ora consolidate nella classe com.adobe.primetime.va.simple.MediaHeartbeatConfig
.
Per informazioni sulla migrazione dalla versione 1.x alla versione 2.x, consulta la documentazione dell’implementazione legacy.