vod_media_set_override_json
该 `vod_media_set_override_json` 指令允许使用 JSON 格式的数据覆盖基于 NGINX 的视频点播 (VOD) 模块中的媒体设置。
NGINX-based VOD Packager
·
httpserverlocation
语法vod_media_set_override_json "JSON_STRING";
默认值none
上下文http, server, location
参数1
说明
该 vod_media_set_override_json 指令用于基于 NGINX 的 VOD 模块中，以实现动态媒体配置。当指定时，该指令允许用户提供一个 JSON 字符串作为参数，用于定义各种媒体参数，例如比特率设置、编解码器和自定义流选项。这在处理需要不同配置的媒体文件时尤其有用，无需直接修改服务器的静态配置。
该指令接受单个参数，且该参数必须是有效的 JSON 字符串。该 JSON 的格式可以变化，从而可精细控制诸如自适应码率流等参数，或设置即将提供的媒体文件的特定特性。处理时，会解析 JSON 数据，指定的媒体选项将优先于在匹配上下文 (http, server, location) 中为 VOD 请求之前定义的任何设置。这在媒体行为因请求或来源而异的场景中表现良好，允许灵活且高效的媒体管理。
务必确保所提供的 JSON 格式正确，因为语法错误可能导致配置错误，从而导致媒体请求失败或行为异常。此外，要有效使用此指令，可能需要了解可以通过 JSON 设置的相关参数，以充分利用其功能。
配置示例
server {
listen 80;
location /media {
vod_media_set_override_json "{ \"bitrate\": \"1500kbps\", \"codec\": \"H264\" }";
# Other configurations...
}
}⚠
确保 JSON 格式有效；语法错误会破坏配置。
⚠
将此指令与其他指令结合使用时，请了解优先级，因为这只会对匹配的请求覆盖先前的设置。
⚠
请谨慎测试更改，因为如果 JSON 与预期值不一致，可能会导致媒体行为异常。