Scopri come configurare Streaming Media Analytics per dispositivi Android.
Con la fine del supporto per gli SDK della versione 4 per dispositivi mobili il 31 agosto 2021, Adobe terminerà anche il supporto per l’SDK di Media Analytics per iOS e Android. Per ulteriori informazioni, consulta Domande frequenti relative alla fine del supporto dell’SDK di Media Analytics.
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:
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 directory libs/
.
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.
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
:
// 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
.
public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
// 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
e MediaHertbeatDelegate
per creare la MediaHeartbeat
.
// Replace <MediaHertbeatDelegate> with your delegate instance
MediaHeartbeat _heartbeat =
new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
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.