Documentatie Analytics Handleiding voor Streaming Media-services

Overzicht overview

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.

Het hoofdstuk en het segment volgen is beschikbaar voor douane-bepaalde media hoofdstukken of segmenten. Bij het bijhouden van hoofdstukken wordt vaak gebruik gemaakt van aangepaste segmenten die zijn gebaseerd op media-inhoud (zoals honkbal-waarschuwingen), of van het definiëren van inhoudssegmenten tussen ad-hocafbrekingen. Het volgen van het hoofdstuk wordt niet vereist voor kernmedia volgende implementaties.

Het volgen van het hoofdstuk omvat hoofdstukbegin, hoofdstuk voltooit, en hoofdstukoverslagen. U kunt de mediaspeler-API met aangepaste segmentatielogica gebruiken om hoofdstukgebeurtenissen te identificeren en de vereiste en optionele hoofdstukvariabelen te vullen.

Gebeurtenissen van Player

Bij starten van hoofdstuk

Maak de instantie van het hoofdstukobject voor het hoofdstuk, chapterObject
De hoofdstukmetagegevens vullen, chapterCustomMetadata
Roep trackEvent(MediaHeartbeat.Event.ChapterStart, chapterObject, chapterCustomMetadata);

Bij hoofdstuk voltooid

Roep trackEvent(MediaHeartbeat.Event.ChapterComplete);

Bij overslaan van hoofdstuk

Roep trackEvent(MediaHeartbeat.Event.ChapterSkip);

Hoofdstuk bijhouden implementeren implement-chapter-tracking

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

Hier volgt de naslaggids voor hoofdstuk ChapterObject :

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

Als u aangepaste metagegevens voor het hoofdstuk opneemt, maakt u de variabelen voor contextgegevens voor de metagegevens.
Roep de gebeurtenis ChapterStart in de MediaHeartbeat -instantie aan om het afspelen van het hoofdstuk te starten.
Wanneer het afspelen de eindgrens van het hoofdstuk bereikt, zoals gedefinieerd door uw aangepaste code, roept u de gebeurtenis ChapterComplete in de instantie MediaHeartbeat aan.
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.
Als er nog hoofdstukken zijn, herhaalt u stap 1 tot en met 5.

In de volgende voorbeeldcode wordt de JavaScript 2.x SDK voor een HTML5-mediaspeler gebruikt. Gebruik deze code met de afspeelcode voor de kernmedia.

/* Call on chapter start */
if (e.type == "chapter start") {
    var chapterObject = MediaHeartbeat.createChapterObject("Inning 5",5,500,2500);
    /* Set custom context data*/
    var chapterCustomMetadata = {
        segmentType:"Baseball Innings",
        segmentName:"Inning 5",
        segmentInfo:"Game Six"
    }
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterStart,
                                   chapterObject,
                                   chapterCustomMetadata);
};

/* Call on chapter complete */
if (e.type == "chapter complete") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterComplete);
};

/* Call on chapter skip */
if (e.type == "chapter skip") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.ChapterSkip);
};

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb