Le istruzioni seguenti forniscono indicazioni per l'implementazione tramite SDK 2.x.
Se implementi una versione 1.x dell'SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.
Identificare quando si verifica l'evento di inizio del capitolo e creare l'istanza ChapterObject
utilizzando le informazioni del capitolo.
ChapterObject
riferimento di tracciamento dei capitoli:
Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.
Nome variable | Descrizione | Obbligatorio |
---|---|---|
name |
Nome del capitolo | Sì |
position |
Posizione del capitolo | Sì |
length |
Lunghezza del capitolo | Sì |
startTime |
Ora di inizio capitolo | Sì |
Oggetto capitolo:
MediaObject chapterDataInfo =
MediaHeartbeat.createChapterObject(<CHAPTER_NAME>,
<POSITION>,
<LENGTH>,
<START_TIME>);
Se includi metadati personalizzati per il capitolo , crea le variabili di dati di contesto per i metadati:
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");
Per iniziare a tenere traccia della riproduzione del capitolo, chiama l'evento ChapterStart
nell'istanza MediaHeartbeat
:
public void onChapterStart(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
chapterDataInfo,
chapterMetadata);
}
Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, invoca l'evento ChapterComplete
nell'istanza MediaHeartbeat
:
public void onChapterComplete(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete, null, null);
}
Se la riproduzione del capitolo non è stata completata perché l'utente ha scelto di saltare il capitolo (ad esempio, se l'utente cerca fuori dal limite del capitolo), chiamare l'evento ChapterSkip
nell'istanza MediaHeartbeat:
public void onChapterSkip(Observable observable, Object data) {
_heartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip, null, null);
}
In caso di capitoli aggiuntivi, ripetere i punti da 1 a 5.