Configurazione Android

IMPORTANTE

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);
    
    IMPORTANTE

    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.

In questa pagina