Show Menu
ARGOMENTI×

Tracciare capitoli e segmenti su iOS

Le istruzioni seguenti forniscono indicazioni per l’implementazione mediante gli SDK 2.x. Se stai implementando una versione 1.x dell’SDK, puoi scaricare la Guida per gli sviluppatori qui: Scaricare gli SDK.
  1. Identificare il momento in cui si verifica l’evento di inizio del capitolo e creare l’ ChapterObject istanza utilizzando le informazioni sul capitolo.
    ChapterObject riferimento tracciamento capitoli:
    Queste variabili sono necessarie solo se si prevede di tenere traccia dei capitoli.
    Nome della variabile
    Descrizione
    Obbligatorio
    name
    Nome del capitolo
    position
    Posizione del capitolo
    length
    Lunghezza capitolo
    startTime
    Ora inizio capitolo
    Oggetto Chapter:
    id chapterObject =  
      [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME] 
                         position:[POSITION] 
                         length:[LENGTH] 
                         startTime:[START_TIME]];
    
    
  2. Se includete metadati personalizzati per il capitolo, create 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 monitorare la riproduzione dei capitoli, chiamate l’ ChapterStart evento nell’ MediaHeartbeat istanza:
    - (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, chiamate l’ ChapterComplete evento nell’ MediaHeartbeat istanza:
    - (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 di uscire dal limite del capitolo), chiamate l’ ChapterSkip evento nell’istanza MediaHeartbeat:
    - (void)onChapterSkip:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip  
                         mediaObject:nil  
                         data:nil]; 
    }
    
    
  6. Se sono presenti altri capitoli, ripetete i punti da 1 a 5.