Show Menu
TOPICS×

Configurare Android

Prerequisiti

  • Ottenete parametri di configurazione validi per Media SDK
    Questi parametri possono essere ottenuti da un rappresentante Adobe dopo la configurazione dell'account di analisi.
  • Implementa ADBMobile per Android nella tua applicazione
    Per ulteriori informazioni sulla documentazione SDK per Adobe Mobile, consulta Android SDK 4.x 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. Seleziona
        Open Module Settings
        .
      3. In
        Project Settings
        , selezionare
        Libraries
        .
      4. Click
        +
        to add a new library.
      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:
      8. Nell’IDE Eclipse, fai clic con il pulsante destro del mouse sul nome del progetto.
      9. Fai clic su
        Build Path
        >
        Add External Archives
        .
      10. Seleziona
        MediaSDK.jar
        .
      11. Fai clic su
        Open
        .
      12. Fate nuovamente clic con il pulsante destro del mouse sul progetto e fate clic su
        Build Path
        >
        Configure Build Path
        .
      13. Fare clic sulle schede
        Order
        e
        Export
        .
      14. 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
    MediaHeartbeatConfig
    di inizializzazione:
    // 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.