Menu

Lumen help

Integrating Mesh Delivery with Kaltura v7

Introduction

Mesh Delivery for Streaming can be integrated into your website with Kaltura Player.

 

We have built optimized plugins for Kaltura Player from 0.50.9.

 

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

Note: This plugin only works with the Kaltura Player V7 using the Dynamic Embed method.

Step 1: Install Kaltura Player v7 and Mesh Delivery builds

Include these sources in the HTML <head>:

                <!-- Kaltura Player build -->
<script src="YOUR_PLAYER_URL"></script>

<!-- Mesh Delivery plugin -->
<script src="//cdn.streamroot.io/playkit-dna-plugin/1/stable/playkit-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.
YOUR_PLAYER_URL Yes The cloud-hosted player library URL from your KMC dashboard.

Step 2: Set up Kaltura v7 and Mesh Delivery

Include the following code in the HTML <body> :

                <div id="kaltura_player_xxxxxxxxxx" style="width: 560px;height: 395px"></div>
<script type="text/javascript">
  try {
    var kalturaPlayer = KalturaPlayer.setup({
      targetId: "kaltura_player_xxxxxxxxxx",
      provider: {
        partnerId: xxxxxxx,
        uiConfId: xxxxxxx
      },
      plugins: {
        streamroot: {
          key: "YOUR_STREAMROOT_KEY",
          dnaConfig: {}
        }
      },
    });
    kalturaPlayer.loadMedia({
      entryId: "YOUR_MEDIA_ENTRY_ID"
    });
  } catch (e) {
      console.error(e.message);
  }
</script>

Parameter name

Mandatory

Description

dnaConfig

No

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

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.

YOUR_MEDIA_ENTRY_ID

Yes

The media ID you get from Kaltura KMC

 

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 and Shaka Player options

hls.js and Shaka Player have a wide variety of configuration parameters that can be instantiated for fine-tuning. Depending on which media engine you are using, we recommend setting the following values to get the best performance on live events:

                playback: {
  options: {
    html5: {
      hls: {
        maxBufferSize: 0,
        maxBufferLength: 30,
        liveSyncDuration: 30,
        liveMaxLatencyDuration: Infinity
      },
      dash: {
        streaming: {
          bufferingGoal: 30
        },
        manifest: {
          dash: {
            defaultPresentationDelay: 30
          }
        }
      }
    }
  }
}

For HLS VOD streams, liveSyncDuration and liveMaxLatencyDuration are not needed.

For DASH Live stream, defaultPresentationDelay should be set as shown above or directly in your manifest in suggestedPresentationDelay.

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.