npm
Pars een VMAP XML-document naar een Javascript-object. Voldoet aan de VMAP 1.0.1 spec.
Installatie
Installeer met npm
npm install vmap
Gebruik
Voeg de VMAP
constructor een XML in om er een geparseerde versie van te krijgen.
Toegang tot VMAP
-eigenschappen met behulp van de hieronder gedocumenteerde API’s.
import VMAP from 'vmap';// Fetch VMAP as XMLconst xhr = new XMLHttpRequest();xhr.open('GET', vmapURL);xhr.send();xhr.onreadystatechange = function() { if (xhr.readyState === xhr.DONE) { if (xhr.status === 200) { // Get a parsed VMAP object const vmap = new VMAP(xhr.responseXML); } }};
API
VMAP
Eigenschappen
-
version
: De VMAP versie (moet 1.0 zijn). -
adBreaks
: Een array vanVMAPAdBreak
objecten. -
extensions
: Een array vanObject
met-
children
:Object
met al deze uitbreidingskinderen en hun naam als sleutel -
attribute
:Object
met alle attributen van deze extensie en hun naam als sleutel -
value
:Object
geparsed uit CDATA of als fallback alle tekstknooppunten van deze extensie aaneengeschakeld
-
VMAPAdBreak
Levert informatie over een advertentiepauze.
Eigenschappen
-
timeOffset
: Geeft de timing van de advertentie onderbreking weer. -
breakType
: Geeft aan of de advertentie onderbreking “lineaire”, “niet-lineaire” of “weergave” advertenties toestaat. -
breakId
: Een optionele string-identifier voor de ad break. -
repeatAfter
: Een optie die wordt gebruikt om advertentie-einden op gelijke afstand van elkaar te verdelen langs een lineaire tijdlijn. -
adSource
: EenVMAPAdSource
object. -
trackingEvents
: Een array vanObject
met tracking URL’s-
event
: De naam van de gebeurtenis die voor het element moet worden gevolgd. Kan een van breakStart, breakEnd of error zijn. -
uri
: De URI van de tracker.
-
-
extensions
: Een array vanObject
met-
children
:Object
met al deze uitbreidingskinderen en hun naam als sleutel -
attribute
:Object
met daarin alle attributen van deze extensie en hun naam als sleutel -
value
:Object
geparsed uit CDATA of als fallback alle tekstknooppunten van deze extensie samengevoegd
-
Methoden
-
track(event, errorCode)
: Roept de trackers voor de gegeven gebeurtenis op met een optionele foutcodeparameter voorerror
-gebeurtenissen.
VMAPAdSource
Voorziet de speler van ofwel een inline advertentie-respons of een verwijzing naar een advertentie-respons.
Eigenschappen
-
id
: Ad-identifier voor de advertentiebron. -
allowMultipleAds
: Geeft aan of een VAST-advertentiepod of een meervoudig buffet van advertenties kan worden geserveerd in een advertentiepauze. -
followRedirects
: Geeft aan of de videospeler de omleidingen binnen een advertentierespons moet honoreren. -
vastAdData
: Bevat een ingesloten VAST-respons. -
adTagURI
: Bevat een URI naar de VAST. -
customData
: Bevat aangepaste advertentiegegevens.
Ondersteuning en compatibiliteit
De bibliotheek is 100% geschreven in JavaScript en de broncode maakt gebruik van moderne functies zoals modules
, classes
, ecc… . Zorg ervoor dat uw omgeving deze functies ondersteunt, of transpileer de bibliotheek bij het bundelen van uw project.
Voorgebundelde versies
We bieden verschillende voorgebundelde versies van de bibliotheek (zie dist
directory)
Browser
Een voorgebundelde versie van VMAP-jsis beschikbaar: vmap-js.js
.
U kunt het script direct aan uw pagina toevoegen en de bibliotheek benaderen via de VMAP
constructor.
<script src="dist/vmap-js.js"></script>
var vmap = new VMAP(vmapXML);
Node
Een pre-bundled versie voor node is ook beschikbaar: vmap-js-node.js
.
const VMAP = require('vmap')const vmap = new VMAP(vmapXML);
Bouw en test
Installeer afhankelijkheden met:
npm install
Het project is gebundeld met behulp van Rollup. Bouwen met:
npm run-script build
Testen uitvoeren met:
npm test