DocumentatieAnalyticsHandleiding voor Streaming Media-services

Hoofdstukken en segmenten bijhouden op iOS track-chapters-and-segments-on-ios

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

De volgende instructies bieden richtlijnen voor implementatie met 2.x SDK's.

IMPORTANT
Als u een versie 1.x van SDK uitvoert, kunt u de Gids van Ontwikkelaars hier downloaden: ​ Download SDKs.

  1. Bepaal wanneer de hoofdstukstartgebeurtenis plaatsvindt en maak de ChapterObject -instantie met behulp van de hoofdstukinformatie.

    ChapterObject referentie voor het bijhouden van hoofdstukken:

    note note
    NOTE
    Deze variabelen zijn alleen vereist als u hoofdstukken wilt bijhouden.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Naam variabele Beschrijving Vereist
    name Hoofdstuknaam Ja
    position Hoofdstukpositie Ja
    length Lengte van hoofdstuk Ja
    startTime Begintijd van hoofdstuk Ja

    Object Chapter:

    code language-none 
    id chapterObject =
  [ADBMediaHeartbeat createChapterObjectWithName:[CHAPTER_NAME]
                     position:[POSITION]
                     length:[LENGTH]
                     startTime:[START_TIME]];

  2. Als u aangepaste metagegevens voor het hoofdstuk opneemt, maakt u de variabelen voor contextgegevens voor de metagegevens:

    code language-none 
    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. Roep de gebeurtenis ChapterStart in de MediaHeartbeat -instantie aan om het afspelen van het hoofdstuk te starten:

    code language-none 
    - (void)onChapterStart:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterStart
                     mediaObject:chapterObject
                     data:chapterDictionary];
}

  4. Wanneer het afspelen de eindgrens van het hoofdstuk bereikt, zoals gedefinieerd door uw aangepaste code, roept u de gebeurtenis ChapterComplete op in de instantie MediaHeartbeat :

    code language-none 
    - (void)onChapterComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterComplete
                     mediaObject:nil
                     data:nil];
}

  5. Als het afspelen van het hoofdstuk niet is voltooid omdat de gebruiker het hoofdstuk heeft overgeslagen (bijvoorbeeld als de gebruiker buiten de hoofdstukgrens zoekt), roept u de gebeurtenis ChapterSkip in de MediaHeartbeat-instantie aan:

    code language-none 
    - (void)onChapterSkip:(NSNotification *)notification {
    [_mediaHeartbeat trackEvent:ADBMediaHeartbeatEventChapterSkip
                     mediaObject:nil
                     data:nil];
}

  6. Als er nog hoofdstukken zijn, herhaalt u stap 1 tot en met 5.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb