Core playback volgen met JavaScript 2.x track-core-playback-on-javascript

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

IMPORTANT
Als u een 1.x versie van SDK uitvoert, kunt u 1.x de Gidsen van Ontwikkelaars hier downloaden: ​ Download SDKs ​
  1. Aanvankelijke het volgen opstelling

    Bepaal wanneer de gebruiker de afspeelintentie activeert (de gebruiker klikt op Afspelen en/of Automatisch afspelen is ingeschakeld) en maak een MediaObject -instantie.

    ​ 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
    Naam variabele Beschrijving Vereist
    name Mediumnaam Ja
    mediaid Unieke id voor media Ja
    length Medialengte Ja
    streamType Het type van stroom (zie constanten StreamType hieronder) Ja
    mediaType Het type van media (zie constanten MediaType hieronder) Ja

    StreamTypeconstanten:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Naam van constante Beschrijving
    VOD Het type van stroom voor Video op bestelling.
    LIVE Stroomtype voor LIVE-inhoud.
    LINEAR Het type van stroom voor inhoud LINEAR.
    AOD Het type van stroom voor Audio op bestelling.
    AUDIOBOOK Streaming type voor audioboek.
    PODCAST Het type van stroom voor Podcast.

    MediaTypeconstanten:

    table 0-row-2 1-row-2 2-row-2
    Naam van constante Beschrijving
    Audio Mediatype voor audiostreams.
    Video Mediatype voor videostreams.
    code language-none
    var mediaObject =
      MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
                                      <MEDIA_ID,
                                      <MEDIA_LENGTH>,
                                      MediaHeartbeat.StreamType.VOD,
                                      <MEDIA_TYPE>);
    
  2. verbind meta-gegevens

    Koppel standaard- en/of aangepaste metagegevensobjecten optioneel aan de volgende sessie via variabelen voor contextgegevens.

    • Standaard meta-gegevens

      Standaardmetadata implementeren in JavaScript

      note note
      NOTE
      Het koppelen van het standaardobject voor metagegevens aan het mediaobject is optioneel.
    • de meta-gegevens van de Douane

      Maak een veranderlijk object voor de douanevariabelen en bevolk met de gegevens voor deze media. Bijvoorbeeld:

      code language-js
      /* Set custom context data */
      var customVideoMetadata = {
          isUserLoggedIn: "false",
          tvStation: "Sample TV station",
          programmer: "Sample programmer"
      };
      
  3. Spoor de intentie om playback te beginnen

    Als u een mediasessie wilt volgen, roept u trackSessionStart aan op de Media Heartbeat-instantie:

    code language-js
    mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
    
    note tip
    TIP
    De tweede waarde is de objectnaam voor aangepaste mediametagegevens die u in stap 2 hebt gemaakt.
    note important
    IMPORTANT
    In trackSessionStart wordt bijgehouden wat de gebruiker wil afspelen, niet het begin van het afspelen. Deze API wordt gebruikt om de gegevens/meta-gegevens te laden en tijd-aan-begin metrische QoS (de tijdduur tussen trackSessionStart en trackPlay) te schatten.
    note note
    NOTE
    Als u geen aangepaste metagegevens gebruikt, verzendt u gewoon een leeg object voor het argument data in trackSessionStart , zoals getoond in de regel met opmerkingen in het bovenstaande iOS-voorbeeld.
  4. spoor het daadwerkelijke begin van playback

    Identificeer de gebeurtenis van de mediaspeler voor het begin van het afspelen, waar het eerste frame van de media op het scherm wordt weergegeven, en roep trackPlay aan:

    code language-js
    mediaHeartbeat.trackPlay();
    
  5. Spoor de voltooiing van playback

    Identificeer de gebeurtenis van de media speler voor de voltooiing van het playback, waar de gebruiker de inhoud tot het eind heeft bekeken, en roep trackComplete:

    code language-js
    mediaHeartbeat.trackComplete();
    
  6. Spoor het eind van de zitting

    Identificeer de gebeurtenis van de mediaspeler voor het verwijderen/sluiten van het afspelen, waar de gebruiker de media en/of de media sluit en verwijderd is, en roep trackSessionEnd aan:

    code language-js
    mediaHeartbeat.trackSessionEnd();
    
    note important
    IMPORTANT
    trackSessionEnd markeert het einde van een volgende sessie. Als de sessie succesvol is gecontroleerd op voltooiing, waarbij de gebruiker de inhoud tot het einde heeft gecontroleerd, controleert u of trackComplete vóór trackSessionEnd is aangeroepen. Eventuele andere track* API-aanroepen worden na trackSessionEnd genegeerd, behalve voor trackSessionStart voor een nieuwe traceringssessie.
  7. spoor alle mogelijke pauzescenario's

    Identificeer de gebeurtenis van de media speler voor pauze en vraag trackPause:

    code language-js
    mediaHeartbeat.trackPause();
    

    Scenario's van de Pauze

    Identificeer om het even welk scenario waarin de media speler zal pauzeren en zorg ervoor dat trackPause behoorlijk wordt geroepen. De volgende scenario's vereisen allemaal dat uw app trackPause() aanroept:

    • De gebruiker raakt expliciet de pauze in de app.
    • De speler plaatst zichzelf in de pauzestatus.
    • (Mobiele Apps) - de gebruiker zet de toepassing in de achtergrond, maar u wilt dat app de zitting open houdt.
    • (Mobiele Apps) - om het even welk type van systeem onderbreekt komt voor dat een toepassing veroorzaakt om worden gesteund. Bijvoorbeeld, ontvangt de gebruiker een vraag, of een pop-up van een andere toepassing komt voor, maar u wilt de toepassing de zitting levend houden om de gebruiker de kans te geven om de media van het punt van onderbreking te hervatten.
  8. Identificeer de gebeurtenis van de speler voor spel en/of hervat van pauze en vraag trackPlay:

    code language-js
    mediaHeartbeat.trackPlay();
    
    note tip
    TIP
    Dit kan de zelfde gebeurtenisbron zijn die in Stap 4 werd gebruikt. Zorg ervoor dat elke API-aanroep van trackPause() wordt gekoppeld aan een volgende API-aanroep van trackPlay() wanneer het afspelen wordt hervat.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb