Android instellen set-up-android

Leer hoe u Streaming Media Analytics voor Android-apparaten instelt.

IMPORTANT
Aan het einde van de ondersteuning voor versie 4 Mobile SDK's op 31 augustus 2021 beëindigt Adobe ook de ondersteuning voor de Media Analytics SDK voor iOS en Android. Zie voor meer informatie Veelgestelde vragen over einde van ondersteuning voor Media Analytics SDK.

Vereisten

  • Geldige configuratieparameters verkrijgen voor de Media SDK
    Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw analyseaccount hebt ingesteld.

  • ADBMobile for Android implementeren in uw toepassing
    Voor meer informatie over de documentatie van Adobe Mobile SDK, zie Android SDK 4.x voor Experience Cloud Solutions.

  • Biedt de volgende mogelijkheden in uw mediaspeler:

    • Een API die zich moet abonneren op spelergebeurtenissen - De SDK van Media vereist dat u een set eenvoudige API's oproept wanneer gebeurtenissen in de speler plaatsvinden.
    • Een API die spelerinformatie biedt - Deze informatie bevat details zoals de medianaam en de positie van de afspeelkop.

SDK-implementatie

  1. Voeg de gedownloade SDK van Media toe aan uw project.

    1. Vouw het ZIP-bestand van Android uit (bijvoorbeeld MediaSDK-android-v2.*.zip).

    2. Controleer of de MediaSDK.jar bestand bestaat in het dialoogvenster libs/ directory.

    3. Voeg de bibliotheek aan uw project toe.

      IntelliJ IDEA:

      1. Klik met de rechtermuisknop op uw project in het deelvenster Project navigation.

      2. Selecteren Open Module Settings.

      3. Selecteer onder Project Settings de optie Libraries.

      4. Klikken + om een nieuwe bibliotheek toe te voegen.

      5. Selecteren Java en navigeer naar de MediaSDK.jar bestand.

      6. Selecteer de modules waarin u de mobiele bibliotheek wilt gebruiken.

      7. Klik op Apply en vervolgens op OK om het venster met module-instellingen te sluiten.

      Eclipse:

      1. In winde van de Verduistering, klik op de projectnaam met de rechtermuisknop aan.

      2. Klik op Build Path > Add External Archives .

      3. Selecteren MediaSDK.jar.

      4. Klik op Open.

      5. Klik nogmaals met de rechtermuisknop op het project en klik op Build Path > Configure Build Path .

      6. Klik op de tabbladen Order en Export.

      7. Zorg ervoor dat de MediaSDK.jar bestand is geselecteerd.

  2. Importeer de bibliotheek.

    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. Maak de MediaHeartbeatConfig -instantie.

    Hier volgt een voorbeeld van initialisatie van MediaHeartbeatConfig:

    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. Implementeer de MediaHeartbeatDelegate interface.

    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. Maak de MediaHeartbeat -instantie.

    Gebruik de MediaHeartbeatConfig en de MediaHertbeatDelegate instantie om de MediaHeartbeat -instantie.

    code language-java
    // Replace <MediaHertbeatDelegate> with your delegate instance
    MediaHeartbeat _heartbeat =
      new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    
    note important
    IMPORTANT
    Zorg ervoor dat uw MediaHeartbeat -instantie toegankelijk is en wordt pas aan het einde van de sessie detoegewezen. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen tracking.

Toepassingsmachtigingen toevoegen

Uw toepassing die de SDK van Media gebruikt vereist de volgende toestemmingen om gegevens te verzenden bij het volgen van vraag:

  • INTERNET
  • ACCESS_NETWORK_STATE

Voeg de volgende regels toe aan uw AndroidManifest.xml bestand in de projectmap van de toepassing:

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

Migreren van versie 1.x naar 2.x in Android

In versies 2.x, worden alle openbare methodes geconsolideerd in com.adobe.primetime.va.simple.MediaHeartbeat om het voor ontwikkelaars gemakkelijker te maken. Bovendien worden alle configuraties nu geconsolideerd in de com.adobe.primetime.va.simple.MediaHeartbeatConfig klasse.

Raadpleeg de documentatie bij Legacy Implementation voor informatie over het migreren van 1.x naar 2.x.

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