Show Menu
TOPICS×

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.