Android einrichten set-up-android
Erfahren Sie, wie Sie das Streaming Media Collection Add-on für Android-Geräte 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 die folgenden Funktionen in Ihrem Medienplayer bereit:
- Eine API zum Abonnieren von Player-Ereignissen: Das Media SDK erfordert den Aufruf einer Reihe einfacher APIs, wenn im Player Ereignisse auftreten.
- Eine API, die Player-Informationen bereitstellt: Diese Informationen enthalten Details wie den Mediennamen und die Abspielposition.
SDK-Implementierung
-
Fügen Sie Ihr heruntergeladenes Medien-SDK zu Ihrem Projekt hinzu.
-
Erweitern Sie die Android-Zip-Datei (z. B.
MediaSDK-android-v2.*.zip
). -
Stellen Sie sicher, dass die Datei
MediaSDK.jar
im Verzeichnislibs/
vorhanden ist. -
Fügen Sie die Bibliothek zu Ihrem Projekt hinzu.
IntelliJ IDEA:
-
Klicken Sie im Bereich Projektnavigation mit der rechten Maustaste auf Ihr Projekt.
-
Wählen Sie Moduleinstellungen öffnen.
-
Wählen Sie unter Projekteinstellungen die Option Bibliotheken.
-
Klicken Sie auf +, um eine neue Bibliothek hinzuzufügen.
-
Wählen Sie Java und navigieren Sie zur Datei
MediaSDK.jar
. -
Wählen Sie die Module aus, in denen Sie die Mobile-Bibliothek verwenden möchten.
-
Klicken Sie auf Anwenden und dann auf OK, um das Moduleinstellungsfenster zu schließen.
Eclipse:
-
Klicken Sie in der Eclipse IDE mit der rechten Maustaste auf den Projektnamen.
-
Klicken Sie auf Pfad aufbauen > Externe Archive hinzufügen .
-
Auswählen
MediaSDK.jar
. -
Klicken Sie auf Öffnen.
-
Klicken Sie erneut mit der rechten Maustaste auf das Projekt und klicken Sie dann auf Pfad aufbauen > Pfadaufbau konfigurieren.
-
Klicken Sie auf die Tabs Sortierung und Export.
-
Stellen Sie sicher, dass die Datei
MediaSDK.jar
ausgewählt ist.
-
-
-
Importieren Sie die Bibliothek.
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;
-
Erstellen Sie die
MediaHeartbeatConfig
-Instanz.Hier finden Sie eine Beispielinitialisierung für
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>;
-
Implementieren Sie die
MediaHeartbeatDelegate
-Schnittstelle.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>; }
-
Erstellen Sie die
MediaHeartbeat
-Instanz.Verwenden Sie die
MediaHeartbeatConfig
- und dieMediaHertbeatDelegate
-Instanz, um dieMediaHeartbeat
-Instanz zu erstellen.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT 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.
Hinzufügen von App-Berechtigungen
Ihre App, die das Media SDK verwendet, benötigt die folgenden Berechtigungen, um Daten bei 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.
Informationen über die Migration von 1.x auf 2.x finden Sie in der Dokumentation zur Legacy-Implementierung.