Android instellen set-up-android

Leer hoe u de verzameling streamingmedia voor Android-apparaten instelt.

IMPORTANT
Met het einde van de ondersteuning voor versie 4 Mobile SDK's op 31 augustus 2021 zal Adobe ook de ondersteuning voor Media Analytics SDK voor iOS en Android beƫindigen. Voor extra informatie, zie Analytics SDK End-of-Support FAQs.

Vereisten

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

  • voert ADBMobile voor Android in uw toepassing uit
    Voor meer informatie over de documentatie van Adobe Mobile SDK, zie Android SDK 4.x voor de Oplossingen van het Experience Cloud.

  • verstrek de volgende mogelijkheden in uw media speler:

    • API om aan spelergebeurtenissen in te tekenen - de Media SDK vereist dat u een reeks eenvoudige APIs roept wanneer de gebeurtenissen in uw speler voorkomen.
    • API die spelerinformatie verstrekt - Deze informatie omvat details zoals de media naam en de positie van het spelhoofd.

SDK-implementatie

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

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

    2. Controleer of het MediaSDK.jar -bestand in de map libs/ staat.

    3. Voeg de bibliotheek aan uw project toe.

      IntelliJ IDEA:

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

      2. Selecteer Open Module Settings .

      3. Selecteer onder Project Settings de optie Libraries .

      4. Klik op + om een nieuwe bibliotheek toe te voegen.

      5. Selecteer Java en ga naar het 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.

      Verduistering:

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

      2. Klik op Build Path > Add External Archives .

      3. Selecteer 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 het 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 interface 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. Maak de MediaHeartbeat -instantie.

    Gebruik de instantie MediaHeartbeatConfig en de instantie MediaHertbeatDelegate om de instantie MediaHeartbeat te maken.

    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 niet gedealloceerd tot het eind van de zitting. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen tracking.

Toevoegend app toestemmingen

Uw toepassing die Media SDK gebruikt, vereist de volgende machtigingen om gegevens te verzenden bij het bijhouden van aanroepen:

  • INTERNET
  • ACCESS_NETWORK_STATE

Voeg de volgende regels toe aan uw AndroidManifest.xml -bestand in de projectmap van de toepassing om deze machtigingen toe te voegen:

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

migrerend van versie 1.x aan 2.x in Android

In versies 2.x worden alle methoden van het type public geconsolideerd in de klasse com.adobe.primetime.va.simple.MediaHeartbeat , zodat ontwikkelaars deze eenvoudiger kunnen gebruiken. Bovendien worden alle configuraties nu geconsolideerd in de klasse com.adobe.primetime.va.simple.MediaHeartbeatConfig .

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