segmenter_ready_threshold

The `segmenter_ready_threshold` directive sets the minimum number of segments that must be ready before a media stream can start processing.

Syntaxsegmenter_ready_threshold number;
Defaultnone
Context
Arguments1

Description

The segmenter_ready_threshold directive is utilized within the Kaltura Media Framework Common NGINX Module to specify a threshold count for media segments that must be prepared before processing can commence. Essentially, it dictates how many segments need to be available in the buffering queue to ensure seamless streaming without interruptions. This is especially important in live video streaming scenarios where having a certain number of segments ready can prevent latency in starting playback and ensure a smooth user experience.

By configuring this directive, media administrators can tweak the readiness requirements based on their network conditions and user experience expectations. A higher threshold may be desirable for users on slower networks to prevent buffering, while a lower threshold might be suitable for environments with robust bandwidth. The directive takes a single numerical argument which indicates the count of segments that are expected to be ready. This value influences how quickly streams can be initiated, particularly in a dynamic environment where segments are generated and consumed actively.

It's important to note that depending on the infrastructure and load, setting this number too high could delay the start of viewing, while setting it too low could lead to playback issues if the system cannot keep up with demand after the stream starts.

Config Example

segmenter_ready_threshold 5;

Ensure that the number specified is appropriate for your streaming load; too high can lead to delays.

Changes to this directive may require testing to see if it meets real-world performance needs in varied network conditions.

← Back to all directives