segmenter_candidate_margin

The `segmenter_candidate_margin` directive defines a margin for segment candidates in media streaming operations.

Syntaxsegmenter_candidate_margin value;
Defaultnone
Context
Arguments1

Description

The segmenter_candidate_margin directive is used within the Kaltura Media Framework, specifically in configuring the behavior of segment candidates during media streaming. This directive sets a margin parameter that influences the selection or eligibility of segments to be processed or delivered based on their timing or another metric associated with segment candidates. By tuning this margin, administrators can control how closely segments must align with defined timing or thresholds before they are considered viable candidates for processing or playback.

The value provided to the segmenter_candidate_margin directive is essential for optimizing the performance of media delivery systems, particularly in environments where timing precision is critical, such as live streaming applications. Setting this margin too narrowly may result in segments being excluded that could have otherwise contributed to a smooth viewing experience, while setting it too broadly may include segments that are less suitable, potentially degrading quality or consistency. Therefore, careful consideration and testing should be undertaken to determine the most effective margin value based on the specific requirements of the media being processed.

This directive is utilized as part of the configuration for NGINX when deploying the Kaltura Media Framework, contributing to better resource management and improved streaming quality. It is not defined in a typical NGINX context and may need to be included in specific custom configurations to take effect properly.

Config Example

segmenter_candidate_margin 500ms;

Ensure the margin value is appropriate for your media type; too small or too large can lead to poor performance.

The value should be set in a proper time unit (e.g., milliseconds) to ensure it is interpreted correctly.

This directive might not apply if the segmenter module is not enabled or misconfigured.

← Back to all directives