Menu

Lumen help

Integrating Mesh Delivery with Clappr

Introduction

Mesh Delivery for Streaming can be integrated into your website with Clappr player in just a few simple steps.

 

We have built an optimized plugin for Clappr from v0.2.51.

 

The complete list of integrations we support and guides for setting them up can be found here. If you would like to integrate Mesh Delivery for streaming with a video player not on the list, write to us at cdnsupport@lumen.com and we will help you out.

Not into tutorials?  

Code Example

Step 1: Install Clappr and Mesh Delivery builds

Include these sources in the HTML <head>:

                <!-- Clappr build -->
<script src="//cdn.jsdelivr.net/npm/clappr@0.3.1/dist/clappr.min.js"></script>

<!-- Mesh Delivery plugin -->
<script src="//cdn.streamroot.io/clappr-hls-dna-plugin/1/stable/clappr-hls-dna-plugin.js?srKey=YOUR_STREAMROOT_KEY"></script>

To get the highest flexibility of deployment, we recommend setting the StreamrootKey in the Query Parameter "srKey".

 

Parameter name

Mandatory

Description

YOUR_STREAMROOT_KEY

Yes      

The unique Streamroot key that we have assigned to you; make sure it is identical to the one provided in the Account section of your dashboard.

Step 2: Set up Clappr and Mesh Delivery

Include the following code in the HTML <body> :

                <div id="demoplayer"></div>
<script>
  var player = new Clappr.Player({
    source: "YOUR_PLAYLIST_URL", 
    parentId: "#demoplayer",
    plugins: { 
      playback: [HlsDnaPlugin]
    },
    dnaConfig: {},
    hlsjsConfig: {},
  });
</script>

Parameter name

Mandatory

Description

dnaConfig

No

The object in which you can pass Mesh Delivery options (property, contentIdGenerator, id, etc.).

hlsjsConfig

No

The object in which you can change hls.js options. More information can be found in the "Recommended options" section below.

HlsDnaPlugin

Yes

The name of the Mesh Delivery Playback plugin

YOUR_PLAYLIST_URL

Yes

Your HLS playlist.

 

Step 3: Visualize Mesh Delivery

To verify that Mesh Delivery was correctly configured, please install our Mesh Delivery graphs.

Vizualization graph for Mesh Delivery

Recommended Hls.js options

hls.js has a variety of configuration parameters that can be instantiated in hlsjsConfig object for fine-tuning. You can learn more about them in their API Documentation. For optimal performance with live content, we recommend the following values:

                var hlsjsConfig = {
   "maxBufferSize": 0,
   "maxBufferLength": 30,
   "liveSyncDuration": 30,
   "liveMaxLatencyDuration": Infinity
}

liveSyncDuration and liveMaxLatencyDuration are not needed for VOD streams.  

And in just a few easy steps you should have a working integration of Mesh Delivery! We encourage you to explore our documentation to understand the various features we offer so you can make the most out of our product.