Skip to content

Installation (Web)

Obtain the appropriate bundle from the download URL provided by AVEQ. The bundle you receive depends on which video player you use:

  • surfmeter-client-analytics — plain HTML5 <video> element
  • surfmeter-videojs-analytics — Video.js
  • surfmeter-shaka-player-analytics — Google Shaka Player
  • surfmeter-theoplayer-analytics — THEOplayer

Add the bundle to your HTML page via a script tag:

<script src="surfmeter-client-analytics-v1.18.0.js"></script>

Replace the filename with the one you have been provided with. We may provide specific versions for different customers or players.

Player prerequisites

Each adapter expects its player library to be loaded separately (via script tag or npm). The adapter bundles do not include the player itself.

  • Video.js: Requires videojs-contrib-quality-levels for bitrate/resolution/frame rate tracking. Without it, the adapter still works but collects only standard HTML video element metrics.
  • Shaka Player: shaka must be available on the global scope.
  • THEOplayer: Requires THEOplayer v8+. THEOplayer must be available on the global scope.