Lumen help
Introduction
Mesh Delivery for Streaming can be integrated into your website with Akamai Adaptive Media Player (AMP) in just a few simple steps.
We have built an optimized plugin for Akamai Adaptive Media Player from v4.100.7. We support both HLS and DASH engine, and recommend configurations for both in this guide, use whichever is appropriate for your use case.
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?
Step 1: Install AMP and Mesh Delivery builds
Include these sources in the HTML <head>:
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 AMP and Mesh Delivery
Include the following code in the HTML <body> :
HLS & MPEG-DASH
Parameter name |
Mandatory |
Description |
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. |
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_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.
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:
"liveSyncDuration" and "liveMaxLatencyDuration" are not needed for VOD streams.
Recommended Dash.js options
For optimal performance with live content, we recommend setting the following values in the player options:
Mesh Delivery currently has compatibility issues when BOLA is activated on live streams; VOD is not affected. We highly recommend deactivating BOLA for live streaming including DVR streams.
For versions 2.6.0 and later, by default dash.js dynamically switches between throughput-based rules and BOLA. Use the following to disable BOLA and use throughput strategy instead (see dash.js documentation).
Mesh Delivery Termination
If you are going to discard or not use the MediaEngine instance anymore, make sure to properly terminate the Mesh Delivery wrapper manually, by calling the destroy() method of the DashJsDnaWrapper class.
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.
Explore CDN Mesh Delivery