Menu

Lumen help

Asynchronous loading options for Mesh Delivery

Loading our module asynchronously makes the initial module's size is as small as possible to minimize video startup time.


The load timing is configurable by three parameters (in decreasing order of priority):

 

  • 'loadAfterPlaybackStarted'

  • 'fragmentsFetchedBeforeLoad'

  • 'secondsPrebufferedBeforeLoad'


These are mutually exclusive.
 

  • If more than one parameter is defined at the same time, only the one with highest priority is considered.

  • If no parameters are set, the module is loaded directly.


If asynchronous loading is required, the basic configuration 'loadAfterPlaybackStarted' should be used.

 

'fragmentsFetchedBeforeLoad' and 'secondsPrebufferedBeforeLoad' are more advanced and should be used for fine tuning only when the basic configuration is not enough.

 


All parameters are optional.

OPTION NAME

TYPE

DEFAULT

DESCRIPTION

loadAfterPlaybackStarted

Boolean

False

 If true, the bundle is loaded right after the video visually starts to play.

fragmentsFetchedBeforeLoad

Number

N/A

 Number of segments fetched before we load Mesh Delivery.

secondsPrebufferedBeforeLoad

Number

N/A

 Minimum number of seconds in buffer after which we load Mesh Delivery.

 

Important: Misconfiguring one of these parameters can severely impact Mesh Delivery performance and QoS.

Note: 'fragmentsFetchedBeforeLoad' ignores the optional initialization segment(s).

Examples

                dnaConfig: {
  "loadAfterPlaybackStarted": true
}

            
                dnaConfig: {
  "fragmentsFetchedBeforeLoad": 3
}

            
                dnaConfig: {
  "secondsPrebufferedBeforeLoad": 6
}