Hls.js analytics plugin

api.video player analytics module for hls.js based players

hls.js module to call the api.video analytics collector.

Module usage


First include https://unpkg.com/@api.video/hlsjs-player-analytics in your web page.

<script src="https://unpkg.com/@api.video/hlsjs-player-analytics"></script>

Module instanciation

Then, before having instanciated Hls, instanciate a HlsJsApiVideoAnalytics object.

The HlsJsApiVideoAnalytics constructor take the following parameters:

Parameter nameMandatoryTypeDescription
hlsyesHls instancethe instance of Hls
optionsnoHlsJsApiVideoAnalyticsOptions (see below)optional options

Available options (HlsJsApiVideoAnalyticsOptions):

Option nameMandatoryTypeDescription
userMetadatano{ [name: string]: string }[]object containing metadata (see Full example below)
sequenceno{start: number; end?: number;} if only a sequence of the video is going to be played

instanciation example

var hls = new Hls();

new VideoElementApiVideoAnalytics(hls, {
    sequence: {
        start: 10,
        end: 50
    userMetadata: {
        gender: "male"

Full example

Include the module in your HTML file like so:

        <script src="https://cdn.jsdelivr.net/npm/[email protected]"></script>
        <script src="https://unpkg.com/@api.video/hlsjs-player-analytics"></script>
        <video id="video" controls width=640 height=480></video>
        var video = document.getElementById('video');
        var videoSrc = 'https://cdn.api.video/vod/vi5oDagRVJBSKHxSiPux5rYD/hls/manifest.m3u8';
        if (Hls.isSupported()) {
            var hls = new Hls();
            new VideoElementApiVideoAnalytics(hls);

Did this page help you?