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

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 ​

StreamTypeconstanten:

MediaTypeconstanten:

var mediaObject = ADB.Media.createMediaObject(<MEDIA_NAME>,
                                  <MEDIA_ID,
                                  <MEDIA_LENGTH>,
                                  <STREAM_TYPE>,
                                  <MEDIA_TYPE>);

verbind meta-gegevens

Voeg desgewenst standaard- en/of aangepaste metagegevens toe aan de volgende sessie via de variabelen van de contextgegevens.

• Standaard meta-gegevens

  note note
  NOTE
  U kunt de standaardmetagegevens niet koppelen.

  • 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 context data */ var contextData = {}; //Standard metadata contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode"; contextData[ADB.Media.VideoMetadataKeys] = "Sample Show"; //Custom metadata contextData["isUserLoggedIn"] = "false"; contextData["tvStation"] = "Sample TV Station";

Spoor de intentie om playback te beginnen

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

var mediaObject = ADB.Media.createMediaObject("video-name",
                                              "video-id",
                                              60.0,
                                              ADB.Media.StreamType.VOD,
                                              ADB.Media.MediaType.Video);

var contextData = {};

//Standard metadata
contextData[ADB.Media.VideoMetadataKeys] = "Sample Episode";
contextData[ADB.Media.VideoMetadataKeys] = "Sample Show";

//Custom metadata
contextData["isUserLoggedIn"] = "false";
contextData["tvStation"] = "Sample TV Station";

tracker.trackSessionStart(mediaObject, contextData);

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:

tracker.trackPlay();

de waarde van de Update playhead

Wanneer de afspeelkop van media verandert, geeft u een melding aan de SDK door de API mediaUpdatePlayhead aan te roepen.
Voor video-op-verzoek (VOD) wordt de waarde opgegeven in seconden vanaf het begin van het media-item.
Als de speler voor live streaming geen informatie geeft over de duur van de inhoud, kan de waarde worden opgegeven als het aantal seconden sinds middernacht UTC van die dag.

tracker.updatePlayhead(position)

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:

tracker.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 trackSessionEnd aan:

tracker.trackSessionEnd();

spoor alle mogelijke pauzescenario's

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

tracker.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.

Identificeer de gebeurtenis van de speler voor spel en/of hervat van pauze en vraag trackPlay:

tracker.trackPlay();