vod_time_shift_param_name

Sets the name of the query parameter used for time-shifting in NGINX-based VOD packaging.

Syntaxvod_time_shift_param_name name;
Defaultnone
Contexthttp, server, location
Arguments1

Description

The vod_time_shift_param_name directive is utilized within the NGINX-based Video on Demand (VOD) packaging module to define the name of the URL query parameter that signifies a request for time-shifting capabilities. When clients make a request for video streaming with a specific time offset, this parameter is essential for the server to interpret and properly serve the appropriate segment of the video file corresponding to the requested time shift. This functionality is particularly beneficial in scenarios where viewers want to start watching the content from a specific point, rather than the beginning.

This directive can be placed within the http, server, or location contexts, making it flexible for different configurations. The parameter specified will be checked against the incoming request. If the specified time shift parameter is present, the module will handle the request accordingly to serve the appropriate video segment. This enables the VOD server to provide an intuitive and user-friendly viewing experience, facilitating features like catching up with live streams or viewing missed content in VOD scenarios.

In practice, administrators should ensure that the designated query parameter does not conflict with other existing parameters to maintain seamless operation. Proper testing usually involves making requests to the server with various timestamps to confirm the expected behavior in delivering the correct video time ranges.

Config Example

vod_time_shift_param_name time_shift;

Ensure the parameter name does not conflict with other query parameters.

The parameter must be handled appropriately in client requests to achieve intended functionality.

Test extensively as handling time shifts can introduce complexities in video segment delivery.

← Back to all directives