Mit den folgenden Anweisungen können Sie die Implementierung unter Verwendung der 2.x-SDKs vornehmen.
Wenn Sie Version 1.x des SDKs implementieren möchten, können Sie hier das Entwicklerhandbuch herunterladen: SDKs herunterladen.
Ermitteln Sie, wann das Kapitel beginnt, und erstellen Sie die ChapterObject
-Instanz mithilfe dieser Kapitelinformationen.
Kapitel-Tracking-Referenz ChapterObject
:
Diese Variablen sind nur erforderlich, wenn Sie Kapitel verfolgen möchten.
Variablenname | Beschreibung | erforderlich |
---|---|---|
name |
Kapitelname | Ja |
position |
Kapitelposition | Ja |
length |
Kapitellänge | Ja |
startTime |
Startzeit des Kapitels | Ja |
Kapitelobjekt:
MediaObject chapterDataInfo =
MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,
<POSITION>,
<LENGTH>,
<START_TIME>);
Wenn Sie anwenderspezifische Metadaten für das Kapitel hinzufügen, erstellen Sie die Kontextdaten-Variablen für die Metadaten:
HashMap<String, String> chapterMetadata =
new HashMap<String,String>();
chapterMetadata.put("segmentType", "Sample Segment Type");
chapterMetadata.put("segmentName", "Sample Segment Name");
chapterMetadata.put("segmentInfo", "Sample Segment Info");
Um das Tracking der Kapitelwiedergabe zu starten, rufen Sie das ChapterStart
-Ereignis in der MediaHeartbeat
-Instanz auf:
public void onChapterStart(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
chapterDataInfo,
chapterMetadata);
}
Wenn die Wiedergabe das Kapitelende nach Definition Ihres anwenderspezifischen Codes erreicht, rufen Sie das ChapterComplete
-Ereignis in der MediaHeartbeat
-Instanz auf:
public void onChapterComplete(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete, null, null);
}
Wenn die Kapitelwiedergabe nicht abgeschlossen wurde, weil der Anwender das Kapitel übersprungen hat (z. B. zu einer Position außerhalb des Kapitels springt), rufen Sie das ChapterSkip
-Ereignis in der MediaHeartbeat-Instanz auf:
public void onChapterSkip(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null);
}
Wiederholen Sie die Schritte 1 bis 5, wenn es weitere Kapitel gibt.