Show Menu
ARGOMENTI×

Configurazione Android

Con la fine del supporto per gli SDK della versione 4 per dispositivi mobili il 31 agosto 2021, Adobe interromperà anche il supporto per l’SDK di Media Analytics per iOS e Android. Per ulteriori informazioni, consultate Domande frequenti relative alla fine del supporto per l’SDK di Media Analytics .

Prerequisiti

  • Ottenete parametri di configurazione validi per Media SDK Questi parametri possono essere ottenuti da un rappresentante Adobe dopo che avete configurato il vostro account di analisi.
  • Implementa ADBMobile per Android nella tua applicazione Per ulteriori informazioni sulla documentazione SDK per Adobe Mobile, consulta SDK 4.x per Android per le soluzioni Experience Cloud.
  • Fornite le seguenti funzionalità nel lettore multimediale:
    • Un'API per iscriversi agli eventi del lettore - L'SDK di Media richiede che venga chiamato 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

  1. Aggiungi l’SDK per file multimediali scaricato al progetto.
    1. Espandete il file zip Android (ad esempio, MediaSDK-android-v2.*.zip ).
    2. Verificate che il MediaSDK.jar file esista nella libs/ directory.
    3. Aggiungi la libreria al progetto.
      IDEA IntelliJ:
      1. Right click your project in the Project navigation panel.
      2. Select Open Module Settings .
      3. In Project Settings , selezionare Libraries .
      4. Fate clic + per aggiungere una nuova libreria.
      5. Seleziona Java e naviga fino al file MediaSDK.jar .
      6. Selezionate i moduli in cui intendete utilizzare la libreria mobile.
      7. Click Apply and then OK to close the Module Settings window.
      Eclipse:
      1. Nell’IDE Eclipse, fai clic con il pulsante destro del mouse sul nome del progetto.
      2. Fai clic su Build Path > Add External Archives .
      3. Select MediaSDK.jar .
      4. Fai clic su Open .
      5. Fate nuovamente clic con il pulsante destro del mouse sul progetto e fate clic su Build Path > Configure Build Path .
      6. Fare clic sulle schede Order e Export .
      7. Assicurarsi che il MediaSDK.jar file sia selezionato.
  2. 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;
    
    
  3. Create l’ MediaHeartbeatConfig istanza.
    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>;
    
    
  4. Implementare l' MediaHeartbeatDelegate interfaccia.
    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>;
    }
    
    
  5. Create l’ MediaHeartbeat istanza.
    Utilizzate l' MediaHeartbeatConfig istanza e l' MediaHertbeatDelegate istanza per creare l' MediaHeartbeat istanza.
    // Replace <MediaHertbeatDelegate> with your delegate instance
    MediaHeartbeat _heartbeat =  
      new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    
    
    Accertatevi che l’ MediaHeartbeat istanza sia accessibile e che non venga deallocata fino alla fine della sessione . Questa istanza verrà utilizzata per tutti i seguenti eventi di tracciamento.
Aggiunta di autorizzazioni per l'app
L’app che utilizza Media SDK richiede le seguenti autorizzazioni per inviare dati nelle chiamate di tracciamento:
  • INTERNET
  • ACCESS_NETWORK_STATE
To add these permissions, add the following lines to your AndroidManifest.xml file in the application project directory:
  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Migrazione dalla versione 1.x alla 2.x in Android
Nelle versioni 2.x, tutti i metodi pubblici sono consolidati nella com.adobe.primetime.va.simple.MediaHeartbeat classe per semplificare gli sviluppatori. Inoltre, tutte le configurazioni sono ora consolidate nella com.adobe.primetime.va.simple.MediaHeartbeatConfig classe.
Per informazioni dettagliate sulla migrazione da 1.x a 2.x, consultate mig-1x-2x-overview.md.