Show Menu
TOPICS×

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.