vod_lang_param_name
`vod_lang_param_name` 指令指定查询参数的名称,该参数用于在基于 NGINX 的 VOD Packager module 中表明视频内容的语言。
NGINX-based VOD Packager
·
httpserverlocation
语法vod_lang_param_name string;
默认值none
上下文http, server, location
参数1
说明
vod_lang_param_name 指令在 HTTP server 上下文中使用,用于在使用基于 NGINX 的 VOD Packager module 进行视频流传输时配置语言参数。通过定义此指令,管理员可以指定一个自定义的查询参数名称,VOD module 会将其识别为指示所请求媒体所需语言的参数。此功能在媒体以多种语言提供的环境中特别有用,允许客户端通过 URL parameter 请求特定语言的内容。
此指令接受的单个参数是表示参数名称的字符串。例如,如果内容既有英语和西班牙语版本,设置 vod_lang_param_name lang 将允许客户端发出类似 /video?lang=es 的请求以获取西班牙语版本。如果请求未包含此参数,则会应用在服务器其他设置中配置的默认服务语言。vod_lang_param_name 指令在提供本地化内容方面提供了灵活性,通过满足多样化受众来提升用户体验。
由于此指令的作用域仅限于 http, server, and location contexts,因此可根据应用的路由需求有策略地使用。这有助于设置不同的 server or location blocks,以更有效地处理特定语言的请求。
配置示例
server {
listen 80;
server_name example.com;
location /video {
vod_lang_param_name lang;
# Additional configuration for VOD processing
}
}⚠
确保参数名称与客户端请求匹配,以避免语言检测失败。
⚠
如果定义了多个 vod_lang_param_name 实例,请注意只有最后一次出现会生效。
⚠
如果未根据此指令配置可接受的语言文件,可能会导致 404 错误。