Konfigurera Android set-up-android

Lär dig hur du konfigurerar tillägget Streaming Media Collection för Android-enheter.

IMPORTANT
När stödet för version 4 Mobile SDK upphör den 31 augusti 2021 upphör även stödet för Media Analytics SDK för iOS och Android. Mer information finns i Vanliga frågor om supporten för Media Analytics SDK.

Förutsättningar

  • Hämta giltiga konfigurationsparametrar för Media SDK
    Dessa parametrar kan hämtas från en Adobe-representant när du har konfigurerat ditt analyskonto.

  • Implementera ADBMobil för Android i ditt program
    Mer information om Adobe Mobile SDK-dokumentationen finns i Android SDK 4.x for Experience Cloud Solutions.

  • Tillhandahåll följande funktioner i din mediespelare:

    • Ett API för att prenumerera på spelarhändelser - Media SDK kräver att du anropar en uppsättning enkla API:er när händelser inträffar i spelaren.
    • Ett API som tillhandahåller spelarinformation - Den här informationen innehåller information som medienamnet och spelhuvudets position.

SDK-implementering

  1. Lägg till din hämtade Media SDK i ditt projekt.

    1. Expandera zip-filen för Android (t.ex. MediaSDK-android-v2.*.zip).

    2. Kontrollera att filen MediaSDK.jar finns i katalogen libs/.

    3. Lägg till biblioteket i ditt projekt.

      IntelliJ IDEA:

      1. Högerklicka på projektet på panelen Project navigation.

      2. Välj Open Module Settings.

      3. Välj Libraries under Project Settings.

      4. Klicka på + om du vill lägga till ett nytt bibliotek.

      5. Välj Java och navigera till filen MediaSDK.jar.

      6. Välj de moduler där du vill använda det mobila biblioteket.

      7. Klicka på Apply och sedan på OK för att stänga fönstret Modulinställningar.

      Eclipse:

      1. Högerklicka på projektnamnet i Eclipse IDE.

      2. Klicka på Build Path > Add External Archives .

      3. Välj MediaSDK.jar.

      4. Klicka på Open.

      5. Högerklicka på projektet igen och klicka på Build Path > Configure Build Path .

      6. Klicka på flikarna Order och Export.

      7. Kontrollera att filen MediaSDK.jar är markerad.

  2. Importera biblioteket.

    code language-java
    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. Skapa instansen MediaHeartbeatConfig.

    Här följer ett exempel på MediaHeartbeatConfig-initiering:

    code language-java
    // 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. Implementera gränssnittet MediaHeartbeatDelegate.

    code language-java
    public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
    
    code language-java
    // 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. Skapa instansen MediaHeartbeat.

    Använd instansen MediaHeartbeatConfig och instansen MediaHertbeatDelegate för att skapa instansen MediaHeartbeat.

    code language-java
    // Replace <MediaHertbeatDelegate> with your delegate instance
    MediaHeartbeat _heartbeat =
      new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    
    note important
    IMPORTANT
    Kontrollera att din MediaHeartbeat-instans är tillgänglig och att inte frigörs förrän i slutet av sessionen. Den här instansen kommer att användas för alla följande spårningshändelser.

Lägger till programbehörigheter

Ditt program som använder Media SDK kräver följande behörigheter för att skicka data i spårningsanrop:

  • INTERNET
  • ACCESS_NETWORK_STATE

Om du vill lägga till de här behörigheterna lägger du till följande rader i filen AndroidManifest.xml i programmets projektkatalog:

  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Migrerar från version 1.x till 2.x i Android

I version 2.x konsolideras alla publika metoder i klassen com.adobe.primetime.va.simple.MediaHeartbeat så att det blir enklare för utvecklare. Dessutom konsolideras nu alla konfigurationer i klassen com.adobe.primetime.va.simple.MediaHeartbeatConfig.

Mer information om hur du migrerar från 1.x till 2.x finns i dokumentationen för den äldre implementeringen.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb