Show Menu
SUJETS×

Suivi des chapitres et des segments sur iOS

Les instructions suivantes fournissent des conseils pour la mise en œuvre à l’aide des kits SDK 2.x. Si vous mettez en œuvre une version 1.x du kit SDK, vous pouvez télécharger le Guide du développeur dans la rubrique Téléchargement des SDK.
  1. Identifiez le moment où a lieu l’événement de début de chapitre et créez l’instance ChapterObject à l’aide des informations de chapitre.
    ChapterObject référence de suivi de chapitre :
    Ces variables ne sont nécessaires que si vous envisagez d’effectuer le suivi des chapitres.
    Nom de variable
    Description
    Obligatoire
    name
    Nom du chapitre
    Oui
    position
    Position du chapitre
    Oui
    length
    Durée du chapitre
    Oui
    startTime
    Heure de début du chapitre
    Oui
    Objet de chapitre :
    id chapterObject =  
      [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME] 
                         position:[POSITION] 
                         length:[LENGTH] 
                         startTime:[START_TIME]];
    
    
  2. Si vous incluez des métadonnées personnalisées pour le chapitre, créez les variables de données contextuelles pour les métadonnées :
    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. Pour lancer le suivi de la lecture du chapitre, appelez l’événement ChapterStart dans l’instance MediaHeartbeat  :
    - (void)onChapterStart:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart  
                         mediaObject:chapterObject     
                         data:chapterDictionary]; 
    }
    
    
  4. Lorsque la lecture atteint la limite de fin du chapitre, comme défini par votre code personnalisé, appelez l’événement ChapterComplete dans l’instance MediaHeartbeat  :
    - (void)onChapterComplete:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete  
                         mediaObject:nil  
                         data:nil]; 
    }
    
    
  5. Si la lecture du chapitre ne s’est pas terminée car l’utilisateur a choisi d’ignorer le chapitre (par exemple, si l’utilisateur effectue une recherche en dehors de la limite du chapitre), appelez l’événement ChapterSkip dans l’instance MediaHeartbeat :
    - (void)onChapterSkip:(NSNotification *)notification { 
        [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip  
                         mediaObject:nil  
                         data:nil]; 
    }
    
    
  6. S’il existe d’autres chapitres, répétez les étapes 1 à 5.