Le istruzioni seguenti forniscono indicazioni per l’implementazione utilizzando gli SDK 2.x.
Se implementi una versione 1.x dell'SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.
Identifica quando si verifica l’evento di inizio del capitolo e crea l’istanza ChapterObject
utilizzando le informazioni sul capitolo.
Riferimento di tracciamento dei capitoli ChapterObject
:
Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.
Nome variabile | Descrizione | Obbligatorio |
---|---|---|
name |
Nome del capitolo | Sì |
position |
Posizione del capitolo | Sì |
length |
Durata capitolo | Sì |
startTime |
Ora di inizio capitolo | Sì |
Oggetto capitolo:
id chapterObject =
[ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
position:[POSITION]
length:[LENGTH]
startTime:[START_TIME]];
Se includi metadati personalizzati per il capitolo, crea le variabili di dati di contesto per i metadati:
NSMutableDictionary *chapterDictionary = [[NSMutableDictionary alloc] init];
[chapterDictionary setObject:@"Sample segment type" forKey:@"segmentType"];
[chapterDictionary setObject:@"Sample segment name" forKey:@"segmentName"];
[chapterDictionary setObject:@"Sample segment info" forKey:@"segmentInfo"];
Per iniziare a tenere traccia della riproduzione del capitolo, chiama l’evento ChapterStart
nell’istanza MediaHeartbeat
.
- (void)onChapterStart:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart
mediaObject:chapterObject
data:chapterDictionary];
}
Quando la riproduzione raggiunge il limite finale del capitolo, come definito dal codice personalizzato, chiama l’evento ChapterComplete
nell’istanza MediaHeartbeat
.
- (void)onChapterComplete:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete
mediaObject:nil
data:nil];
}
Se la riproduzione del capitolo non è stata completata perché l’utente ha scelto di saltare il capitolo (ad esempio, se l’utente effettua una ricerca fuori dal limite del capitolo), chiama l’evento ChapterSkip
nell’istanza MediaHeartbeat:
- (void)onChapterSkip:(NSNotification *)notification {
[_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip
mediaObject:nil
data:nil];
}
Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.