Menu

Lumen help

Integrating Mesh Delivery with Kaltura

Introduction

Mesh Delivery for Streaming can be integrated into your website with Kaltura Player. 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
Demo

Important: This plugin has been specially built to work with the Kaltura Management Console.
It currently only supports HLS Live and VoD streams.

Step 1: Add Mesh Delivery as a custom script file

In the KMC, go to your player setting in the STUDIO section > Plugins.

 

Create a new plugin called "streamrootDna".


Copy/paste the Mesh Delivery plugin URL in the object called "iframeHTML5Js":


                //cdn.streamroot.io/kaltura-hls-dna-plugin/1/stable/kaltura-hls-dna-plugin.js?srKey=YOUR_STREAMROOT_KEY

Step 2: Add Mesh Delivery options

Add the following 'Options' as new objects: 

                streamrootKey    YOUR_STREAMROOT_KEY
dnaConfig        ()
hlsjsConfig      ()

For optimal flexibility of deployment, we recommend setting the StreamrootKey in the Query Parameter “srKey”.

 

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 is listed under "Recommended Hls.js

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.
Adding mesh delivery options on the Kaltura console

Step 3: Visualize Mesh Delivery stats in your console

To display basic DNA stats in your browser console, copy/paste the following snippet in the "Custom script" input of your player:

                !function(){function n(){if(window.frames[0].Streamroot.instances.length){var n=window.frames[0].Streamroot.instances[0].stats,t=n.allContents.dnaDownload?n.allContents.dnaDownload/(n.allContents.dnaDownload+n.allContents.cdnDownload)*100:0,a={upload:o(n.allContents.dnaUpload),dna:o(n.allContents.dnaDownload),cdn:o(n.allContents.cdnDownload),efficiency:`${t}%`,peers:n.realtime.dnaSources};console.table(a)}else console.warn("Streamrooot not initialized")}function o(n,o=10){if(0===n)return"0B";var t=o+1||1,a=Math.floor(Math.log(n)/Math.log(1e3));return parseFloat((n/1e3**a).toFixed(t))+["B","KB","MB","GB","TB","PB","EB","ZB","YB"][a]}setInterval(()=>{n()},1e4),n()}();

You should have the following table, which is updated every 10 seconds:

Mesh Delivery stats on browser console

Note: To use Mesh Delivery stats, you need to publish your player using the 'Dynamic Embed' code. Stats will not load with the standard 'Iframe Embed' code.

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.


To get the best performance with live content, we recommend setting the following values:

                hlsjsConfig    ("maxBufferSize": 0, "maxBufferLength": 30, "liveSyncDuration": 30)

Important: 'liveSyncDuration' is not needed for VoD. If used with VoD content, the Kaltura player won't load.

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.