Tracciamento capitoli e segmenti su iOS

Le istruzioni seguenti forniscono indicazioni per l'implementazione tramite SDK 2.x.

IMPORTANTE

Se implementi una versione 1.x dell'SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.

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

    NOTA

    Queste variabili sono necessarie solo se intendi tenere traccia dei capitoli.

    Nome variable Descrizione Obbligatorio
    name Nome del capitolo
    position Posizione del capitolo
    length Lunghezza del capitolo
    startTime Ora di inizio capitolo

    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, invoca 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 cerca fuori dal limite del capitolo), chiamare l'evento ChapterSkip nell'istanza MediaHeartbeat:

    - (void)onChapterSkip:(NSNotification *)notification {
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip  
                         mediaObject:nil  
                         data:nil];
    }
    
  6. In caso di capitoli aggiuntivi, ripetere i punti da 1 a 5.

In questa pagina