Show Menu
TOPICS×

Android einrichten

Voraussetzungen

  • Gültige Konfigurationsparameter für Media SDK festlegen:
    Diese Parameter erhalten Sie nach der Einrichtung Ihres Analytics-Kontos von einem Adobe-Support-Mitarbeiter.
  • ADBMobile für Android in Ihre Anwendung implementieren:
    Weitere Informationen zur Adobe Mobile-SDK-Dokumentation finden Sie unter Android-SDK 4.x für Experience Cloud-Lösungen.
  • Stellen Sie in Ihrem Medienplayer folgende Funktionen bereit:
    • Eine API, um Player-Ereignisse zu abonnieren:
      Die Medien-SDK erfordert, dass Sie einige einfache APIs aufrufen, wenn Ereignisse in Ihrem Player auftreten.
    • Eine API, die Playerinformationen bereitstellt:
      Diese Informationen enthalten Details wie z. B. Medienname und Abspielposition.

SDK-Implementierung

  1. Fügen Sie Ihr heruntergeladenes Medien-SDK zu Ihrem Projekt hinzu.
    1. Erweitern Sie die Android-Zip-Datei (z. B.
      MediaSDK-android-v2.*.zip
      ).
    2. Stellen Sie sicher, dass die Datei
      MediaSDK.jar
      im Verzeichnis
      libs/
      vorhanden ist.
    3. Fügen Sie die Bibliothek zu Ihrem Projekt hinzu.
      IntelliJ IDEA:
      1. Klicken Sie im Bereich
        Projektnavigation
        mit der rechten Maustaste auf Ihr Projekt.
      2. Wählen Sie
        Moduleinstellungen öffnen
        .
      3. Wählen Sie unter
        Projekteinstellungen
        die Option
        Bibliotheken
        .
      4. Klicken Sie auf
        +
        , um eine neue Bibliothek hinzuzufügen.
      5. Wählen Sie
        Java
        und navigieren Sie zur Datei
        MediaSDK.jar
        .
      6. Wählen Sie die Module aus, in denen Sie die Mobile-Bibliothek verwenden möchten.
      7. Klicken Sie auf
        Anwenden
        und dann auf
        OK
        , um das Moduleinstellungsfenster zu schließen.
        Eclipse:
      8. Klicken Sie in der Eclipse IDE mit der rechten Maustaste auf den Projektnamen.
      9. Klicken Sie auf
        Pfad aufbauen
        >
        Externe Archive hinzufügen
        .
      10. Auswählen
        MediaSDK.jar
        .
      11. Klicken Sie auf
        Öffnen
        .
      12. Klicken Sie erneut mit der rechten Maustaste auf das Projekt und klicken Sie dann auf
        Pfad aufbauen
        >
        Pfadaufbau konfigurieren
        .
      13. Klicken Sie auf die Tabs
        Sortierung
        und
        Export
        .
      14. Stellen Sie sicher, dass die Datei
        MediaSDK.jar
        ausgewählt ist.
  2. Importieren Sie die Bibliothek.
    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. Erstellen Sie die
    MediaHeartbeatConfig
    -Instanz.
    Hier finden Sie eine Beispielinitialisierung für
    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. Implementieren Sie die
    MediaHeartbeatDelegate
    -Schnittstelle.
    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. Erstellen Sie die
    MediaHeartbeat
    -Instanz.
    Verwenden Sie die
    MediaHeartbeatConfig
    - und die
    MediaHertbeatDelegate
    -Instanz, um die
    MediaHeartbeat
    -Instanz zu erstellen.
    // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    Stellen Sie sicher, dass die
    MediaHeartbeat
    -Instanz zugänglich ist und ihre Zuweisung
    nicht vor Ende der Sitzung aufgehoben wird
    . Diese Instanz wird für alle der folgenden-Tracking-Ereignisse verwendet.
App-Berechtigungen hinzufügen
Ihre App, die das Medien-SDK verwendet, benötigt die folgenden Berechtigungen, um Daten in Tracking-Aufrufen zu senden:
  • INTERNET
  • ACCESS_NETWORK_STATE
Ergänzen Sie die Datei
AndroidManifest.xml
im Projektverzeichnis der Anwendung um die folgenden Zeilen, um diese Berechtigungen hinzuzufügen:
  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Migration von Version 1.x auf 2.x in Android
In den Versionen 2.x sind alle öffentlichen Methoden in der Klasse
com.adobe.primetime.va.simple.MediaHeartbeat
konsolidiert, um die Arbeit der Entwickler zu erleichtern. Außerdem sind alle Konfigurationen nun in der
com.adobe.primetime.va.simple.MediaHeartbeatConfig
-Klasse konsolidiert.
Weitere Informationen zur Migration von 1.x zu 2.x finden Sie unter mig-1x-2x-overview.md.