Erfahren Sie, wie Sie Streaming Media Analytics für Android-Geräte einrichten.
Ab dem 31. August 2021, dem Ende der Unterstützung für Mobile-SDKs der Version 4, stellt Adobe auch die Unterstützung für das Media Analytics-SDK für iOS und Android ein. Weitere Informationen finden Sie unter den häufig gestellten Fragen zum Ende der Unterstützung für das Media Analytics-SDK.
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:
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 Verzeichnis libs/
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.
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
:
// 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.
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>;
}
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.
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.