pckg_m3u8_ctl_skip_boundary_percent

The `pckg_m3u8_ctl_skip_boundary_percent` directive configures the percentage of the media boundary to skip in M3U8 response processing.

Syntaxpckg_m3u8_ctl_skip_boundary_percent percentage;
Defaultnone
Contexthttp, server, location
Arguments1

Description

The pckg_m3u8_ctl_skip_boundary_percent directive in the Kaltura Media Framework Common NGINX Module allows fine-tuning of media segment handling, specifically during the generation of HLS (HTTP Live Streaming) playlists. By specifying a value between 0 and 100, this directive determines the allowable percentage of media boundaries to be skipped when creating M3U8 playlists. This can help in optimizing playback by reducing buffering or managing bandwidth in varying network conditions. The parameter directly affects how segments are treated when they are being compiled into the playlist, ensuring smoother transitions and playback performance.

In practice, this directive is suitable for those who are deploying media applications that leverage live streaming, where precise control over segment boundaries is crucial. Adjusting the percentage can either prioritize continuity of playback (by skipping less) or optimize resource usage (by allowing for more aggressive skipping), depending on the use case. It can be deployed in the http, server, or location contexts, making it flexible for various configuration scenarios based on the server's hierarchy.

When configuring this directive, it's important to communicate with the whole team about its intended value, as changes to this percentage can drastically alter the user's streaming experience and the performance of the server response.

Config Example

location /hls {
    pckg_m3u8_ctl_skip_boundary_percent 15;
}

Setting the value too high could result in skipped segments affecting the playback experience negatively.

Ensure that the specified percentage is within the allowable range of 0 to 100; otherwise, the configuration might fail silently.

← Back to all directives