vod_manifest_duration_policy

`vod_manifest_duration_policy` 指令用于配置视频清单在需要刷新或重新验证之前的有效时长。

语法vod_manifest_duration_policy duration;
默认值none
上下文http, server, location
参数1

说明

vod_manifest_duration_policy 指令在 NGINX VOD 模块中用于控制视频清单被视为有效的持续时间。该设置在提供视频点播 (VOD) 内容时至关重要,因为它决定了客户端何时必须请求新的清单,从而影响内容的新鲜度与缓存行为。通过将时间持续长度作为参数指定,服务器可以管理客户端应多频繁地检查媒体清单的更新,这在诸如自适应码率流媒体等场景中尤为重要,因为流媒体质量可能会根据网络状况发生变化。

当设置了此指令时,它会影响视频清单的缓存行为。如果客户端尝试访问的清单比定义的策略时长更旧,服务器将返回一个新的清单请求,以确保可用的视频轨道或码流质量的任何更改都能被准确反映。这有助于提供无缝的观看体验,特别是对于直播内容或经常更新的 VOD 库。提供给该指令的值通常以秒为单位表示,但也可以根据用例接受更细粒度的时间格式。

该指令可以应用于 httpserverlocation 等不同上下文,允许针对应用堆栈的特定部分进行灵活配置。通过有策略地配置 vod_manifest_duration_policy,内容提供商可以通过降低清单传递的延迟并确保客户端接收最相关的流式传输选项来优化性能和用户体验。

配置示例

location /videos {
    vod_manifest_duration_policy 60s;
}

确保已适当设置 duration 值,以防止频繁且不必要的 manifest 请求。

如果内容经常更改,请避免将 duration 设置得过高,因为这可能导致提供过时的 manifest。

检查 manifest 的 duration 是否与服务器配置中的其他缓存设置兼容。

← 返回所有指令