Articles in this section

See more

Kaltura

Not into tutorials?

     

Note
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 Streamroot plugin

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

Create a new plugin called "streamrootDna".

Copy/paste Streamroot plugin URL in the an object called "iframeHTML5Js".

//cdn.streamroot.io/kaltura-hls-dna-plugin/1/stable/kaltura-hls-dna-plugin.js 

 

Step 2: Add Streamroot options

Add the following Options as new objects.

streamrootKey    YOUR_STREAMROOT_KEY
dnaConfig        ()
hlsjsConfig      ()

 

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.
dnaConfig No

The object in which you can pass Streamroot options (property, id ...).
hlsjsConfig No

The object in which you can change hls.js options. More information can be found hereunder.

 Then click on Save

 

kaltura.png

 

 

Step 3: Visualize DNA stats in your console

To display basic DNA stats in your browser console, copy/paste the following snippet in your console and press Enter.

!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, it will be updated every 10 seconds

 

Note
To use Streamroot Stats, you need to Publish your player using the Dynamic Embed code. Using the standard Iframe Embed code will prevent from loading these Stats in the console.

 

Recommended hls.js options

hls.js as a wide 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 performances with live contents, 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.

Related articles