Tracciare capitoli e segmenti su iOS

Le istruzioni seguenti forniscono indicazioni per l’implementazione utilizzando gli SDK 2.x.

1. 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:

   NOTA

   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]];
   

2. 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"];
   

3. 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];
   }
   

4. 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];
   }
   

5. 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];
   }
   

6. Se ci sono capitoli aggiuntivi, ripeti i punti da 1 a 5.