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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now