vod_lang_param_name
The `vod_lang_param_name` directive specifies the name of the query parameter used to indicate the language of video content in the NGINX-based VOD Packager module.
Description
The vod_lang_param_name directive is utilized within the context of an HTTP server for configuring language parameters when streaming video content using the NGINX-based VOD Packager module. By defining this directive, administrators can specify a custom query parameter name that the VOD module will recognize as indicating the desired language for the media being requested. This functionality is particularly useful in environments where media is available in multiple languages, allowing clients to request specific language renditions of the content through a URL parameter.
The single argument that this directive takes is a string representing the parameter name. For example, if the content includes both English and Spanish versions, setting vod_lang_param_name lang would allow clients to make requests like /video?lang=es to obtain the Spanish version. If a request is made without including this parameter, the default served language will apply as configured elsewhere in the server settings. The vod_lang_param_name directive provides flexibility in serving localized content, enhancing user experience by accommodating diverse audiences.
Because the scope of this directive is limited to http, server, and location contexts, it can be used strategically depending on the routing needs of the application. This can aid in setting up different server or location blocks for handling language-specific requests more efficiently.
Config Example
server {
listen 80;
server_name example.com;
location /video {
vod_lang_param_name lang;
# Additional configuration for VOD processing
}
}Ensure the parameter name matches client requests to avoid failures in language detection.
Be cautious if multiple instances of vod_lang_param_name are defined, as only the last occurrence will take effect.
Forget to configure the acceptable language files in conjunction with this directive may lead to 404 errors.