vod_tracks_param_name
The 'vod_tracks_param_name' directive specifies the name of the query parameter used to select video tracks for adaptive bitrate streaming in the NGINX VOD module.
Description
The 'vod_tracks_param_name' directive is utilized within the NGINX VOD Packager module to determine the name of the query parameter that clients will use to specify which video track they want to stream. This is essential in scenarios where multiple video tracks (e.g., different languages or qualities) are available, allowing clients to request a specific track through their requests.
When configured, this directive acts on requests for video files that support multiple tracks. The specified parameter name will be used in the URL query string to guide the server in identifying which track to deliver to the client. This feature enhances the flexibility of media delivery, allowing video providers to cater to different user preferences and requirements without the need for hardcoding track selection logic in the URLs.
To implement this directive, it should be set in the appropriate contexts (http, server, or location) depending on the scope of the configuration. If the directive is not specified, the system defaults to handling standard cases, possibly leading to the delivery of a default track or requiring additional configuration by the user. Using the correct parameter name ensures the expected behavior in fetching the suitable video stream for clients, thus improving the user experience during video playback.
Config Example
http {
vod_tracks_param_name "track";
server {
location /videos/ {
vod on;
}
}
}Ensure that the specified parameter name does not conflict with existing query parameters used by your application.
Incorrect parameter names may lead to default behavior, delivering an unintended video track or causing playback issues.