DokumentationAnalyticsGuide för strömningstjänster för media

Spåra kärnuppspelning med JavaScript 2.x track-core-playback-on-javascript

Last update: Mon Jul 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare
  • Administratör
  • Utvecklare

Följande instruktioner ger vägledning för implementering i 2.x SDK:er.

IMPORTANT
Om du implementerar en 1.x-version av SDK kan du hämta 1.x-utvecklarhandböcker här: Hämta SDK:er

  1. Inledande spårningsinställning

    Identifiera när användaren aktiverar uppspelningsavsikten (användaren klickar på play och/eller autoplay är aktiverat) och skapar en MediaObject-instans.

    createMediaObject API

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 23-align-center
    Variabelnamn Beskrivning Obligatoriskt
    name Medienamn Ja
    mediaid Unik medieidentifierare Ja
    length Medielängd Ja
    streamType Strömtyp (se StreamType-konstanter nedan) Ja
    mediaType Medietyp (se MediaType-konstanter nedan) Ja

    StreamTypekonstanter:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Konstantnamn Beskrivning
    VOD Strömtyp för Video on Demand.
    LIVE Strömtyp för LIVE-innehåll.
    LINEAR Strömtyp för LINEAR-innehåll.
    AOD Strömtyp för ljud på begäran.
    AUDIOBOOK Strömtyp för ljudbok.
    PODCAST Strömtyp för Podcast.

    MediaTypekonstanter:

    table 0-row-2 1-row-2 2-row-2
    Konstantnamn Beskrivning
    Audio Medietyp för ljudströmmar.
    Video Medietyp för videoströmmar.
    code language-none 
    var mediaObject =
  MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
                                  <MEDIA_ID,
                                  <MEDIA_LENGTH>,
                                  MediaHeartbeat.StreamType.VOD,
                                  <MEDIA_TYPE>);

  2. Bifoga metadata

    Du kan också bifoga standard- och/eller anpassade metadataobjekt till spårningssessionen via kontextdatavariabler.

    • Standardmetadata

      Implementera standardmetadata i JavaScript

      note note
      NOTE
      Det är valfritt att bifoga standardmetadataobjektet till medieobjektet.

    • Anpassade metadata

      Skapa ett variabelobjekt för de anpassade variablerna och fyll i med data för mediet. Exempel:

      code language-js 
      /* Set custom context data */
var customVideoMetadata = {
    isUserLoggedIn: "false",
    tvStation: "Sample TV station",
    programmer: "Sample programmer"
};

  3. Spåra avsikten att starta uppspelningen

    Om du vill börja spåra en mediesession anropar du trackSessionStart på instansen för pulsslag i media:

    code language-js 
    mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
    note tip
    TIP
    Det andra värdet är det anpassade objektnamnet för metadata för media som du skapade i steg 2.
    note important
    IMPORTANT
    trackSessionStart spårar användarens avsikt att spela upp, inte början av uppspelningen. Det här API:t används för att läsa in data/metadata och för att uppskatta QoS-måttet för tid till start (tidsintervallet mellan trackSessionStart och trackPlay).
    note note
    NOTE
    Om du inte använder anpassade metadata skickar du ett tomt objekt för argumentet data i trackSessionStart, vilket visas på den kommenterade utdataraden i iOS-exemplet ovan.

  4. Spåra faktiskt uppspelningsstart

    Identifiera händelsen från mediespelaren för början av uppspelningen, där den första bildrutan i mediet återges på skärmen, och anropa trackPlay:

    code language-js 
    mediaHeartbeat.trackPlay();

  5. Spåra uppspelningen

    Identifiera händelsen från mediespelaren för att slutföra uppspelningen, där användaren har tittat på innehållet tills slutet och anropa trackComplete:

    code language-js 
    mediaHeartbeat.trackComplete();

  6. Spåra slutet av sessionen

    Identifiera händelsen från mediespelaren för borttagning/stängning av uppspelningen, där användaren stänger mediet och/eller mediet har slutförts och har tagits bort, och anropa trackSessionEnd:

    code language-js 
    mediaHeartbeat.trackSessionEnd();
    note important
    IMPORTANT
    trackSessionEnd markerar slutet på en spårningssession. Om sessionen har bevakats till att slutföras, där användaren har tittat på innehållet till slutet, kontrollerar du att trackComplete anropas före trackSessionEnd. Alla andra track* API-anrop ignoreras efter trackSessionEnd, förutom trackSessionStart för en ny spårningssession.

  7. Spåra alla möjliga pausscenarier

    Identifiera händelsen från mediespelaren för att pausa och ringa trackPause:

    code language-js 
    mediaHeartbeat.trackPause();

    Pausa scenarier

    Identifiera alla scenarier där mediespelaren pausar och se till att trackPause anropas korrekt. Följande scenarier kräver att din app anropar trackPause():

    • Användaren träffar uttryckligen paus i appen.
    • Spelaren försätts i pausläget.
    • (Mobilappar) - Användaren placerar programmet i bakgrunden, men du vill att sessionen ska vara öppen i appen.
    • (Mobilappar) - Alla typer av systemavbrott inträffar som gör att ett program backjordas. Användaren får t.ex. ett samtal eller ett popup-fönster från ett annat program inträffar, men du vill att sessionen ska vara aktiv så att användaren kan återuppta mediet från den punkt då det avbröts.

  8. Identifiera händelsen från spelaren för uppspelning och/eller återupptagning från paus och anrop trackPlay:

    code language-js 
    mediaHeartbeat.trackPlay();
    note tip
    TIP
    Detta kan vara samma händelsekälla som användes i steg 4. Se till att varje trackPause() API-anrop paras med ett följande trackPlay() API-anrop när uppspelningen återupptas.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb