Core playback volgen met JavaScript 2.x track-core-playback-on-javascript
De volgende instructies bieden richtlijnen voor implementatie in 2.x SDK's.
-
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.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 nameMediumnaam Ja mediaidUnieke id voor media Ja lengthMedialengte Ja streamTypeHet type van stroom (zie constanten StreamType hieronder) Ja mediaTypeHet 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 VODHet type van stroom voor Video op bestelling. LIVEStroomtype voor LIVE-inhoud. LINEARHet type van stroom voor inhoud LINEAR. AODHet type van stroom voor Audio op bestelling. AUDIOBOOKStreaming type voor audioboek. PODCASTHet type van stroom voor Podcast. MediaTypeconstanten:table 0-row-2 1-row-2 2-row-2 Naam van constante Beschrijving AudioMediatype voor audiostreams. VideoMediatype voor videostreams. code language-none var mediaObject = MediaHeartbeat.createMediaObject(<MEDIA_NAME>, <MEDIA_ID, <MEDIA_LENGTH>, MediaHeartbeat.StreamType.VOD, <MEDIA_TYPE>); -
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 APIVerwijzing van de meta-gegevens van media sleutels - Standaard meta-gegevenssleutels - JavaScript
Zie de uitvoerige reeks van beschikbare meta-gegevens hier: Audio en videoparameters
-
-
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" };
-
-
Spoor de intentie om playback te beginnen
Als u een mediasessie wilt volgen, roept u
trackSessionStartaan 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 trackSessionStartwordt 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 tussentrackSessionStartentrackPlay) te schatten.note note NOTE Als u geen aangepaste metagegevens gebruikt, verzendt u gewoon een leeg object voor het argument dataintrackSessionStart, zoals getoond in de regel met opmerkingen in het bovenstaande iOS-voorbeeld. -
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
trackPlayaan:code language-js mediaHeartbeat.trackPlay(); -
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(); -
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
trackSessionEndaan:code language-js mediaHeartbeat.trackSessionEnd();note important IMPORTANT trackSessionEndmarkeert 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 oftrackCompletevóórtrackSessionEndis aangeroepen. Eventuele anderetrack*API-aanroepen worden natrackSessionEndgenegeerd, behalve voortrackSessionStartvoor een nieuwe traceringssessie. -
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
trackPausebehoorlijk wordt geroepen. De volgende scenario's vereisen allemaal dat uw apptrackPause()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.
-
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 vantrackPlay()wanneer het afspelen wordt hervat.
- Het volgen scenario's: de playback van VOD zonder advertenties
- Voorbeeld van een voorbeeldspeler die bij de JavaScript SDK wordt geleverd voor een volledig voorbeeld van 'tracking'.