ll_segmenter_wait_video_timeout

Configures the timeout for waiting on video segments in the Kaltura Media Framework NGINX module.

Syntaxll_segmenter_wait_video_timeout seconds;
Defaultnone
Context
Arguments1

Description

The ll_segmenter_wait_video_timeout directive is used to specify the maximum time that the Kaltura Media Framework will wait for video segments to become available before timing out. This timeout is crucial for live video streaming applications, where delays in segment availability can significantly affect user experience and cause playback issues. By fine-tuning this value, system administrators can balance between waiting for segments to be ready and ensuring timely responses to viewers.

The directive accepts a single argument, which specifies the timeout duration in seconds. When the specified timeout is reached and segments are still unavailable, the request will fail, and an error will be returned. This helps in avoiding prolonged waits during live streaming scenarios where latency must be minimized. Additionally, it is important to set this value according to the expected latency of the media segments being processed, as setting it too low may result in unnecessary request failures, while setting it too high may lead to longer delays in user feedback.

This directive must be placed within the relevant server or location block where video segment processing takes place. Given its critical role in segment availability, careful consideration should be given to the network topology, server capabilities, and segment generation times when defining this timeout.

Config Example

ll_segmenter_wait_video_timeout 5;

Setting the timeout too low may lead to request failures even for segments that would eventually become available.

High timeout values can lead to longer wait times for users and potentially degraded performance in high-load scenarios.

← Back to all directives