vod_clip_to_param_name

指令 `vod_clip_to_param_name` 指定一个请求参数,该参数决定在视频封装过程中从源文件中剪切的视频内容范围。

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

说明

指令 vod_clip_to_param_name 是基于 NGINX 的 VOD Packager 模块的一部分,允许用户在 HTTP 请求中定义一个参数名,用于指定封装时剪辑视频内容的位置。该指令对于按用户请求需要精确视频片段的视频点播(VOD)服务尤其有用。通过使用此参数,VOD 提供者可以提供定制化的视频播放体验,例如允许用户从视频中的特定时间开始播放。

当在 httpserverlocation 块中配置时,该指令期望一个代表查询参数名称的单一参数,该查询参数在请求中包含剪辑位置。例如,如果用户请求的视频 URL 带有类似 ?start=60 的参数,该指令可以使系统从指定的 60 秒时间戳开始播放视频。此功能适用于流媒体服务和教育平台等应用,在这些场景中按时间定向的内容传递可以提升用户参与度。

在视频封装的上下文中正确处理该参数非常重要。后端实现将依赖对该参数的正确解析以获取并交付正确的内容片段,从而确保视频按用户要求准确剪辑。

配置示例

location /video {
    vod_clip_to_param_name start;
}

确保所提供的参数名称与请求中的查询参数完全匹配。

如果未设置,该指令将默认为 none,这意味着不会发生裁剪。

该指令不应与 location 块中的其他查询参数处理程序冲突。

← 返回所有指令