vod_media_set_map_uri

`vod_media_set_map_uri` 指令为基于 NGINX 的 VOD Packager 模块配置媒体文件的 URI 映射。

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

说明

vod_media_set_map_uri 指令在 httpserverlocation 块内使用,用于定义媒体资源应如何映射到其各自的 URI,以提供视频点播 (VOD) 服务。通常在设置基于 NGINX 的 VOD Packager 时使用,该 Packager 允许即时重新封装多媒体文件,从而支持自适应码率流媒体格式(例如 HLS、DASH 等)。该指令定义的映射有助于服务器基于传入的 HTTP 请求正确解析各种媒体流的文件路径。

该指令接受单个参数,表示媒体文件将被映射到的具体 URI 路径。此 URI 用于指示 VOD 模块从何处获取或提供视频内容。通过配置此指令,可以高效管理媒体资产的处理并确保客户端请求得到正确处理。它在涉及多种媒体格式和自适应流的场景中起关键作用,因为它便于根据 JSON 配置或本地文件路径组织和检索所需资源。

使用 vod_media_set_map_uri 时,必须确保所指定的 URI 与实际文件位置相对应。正确设置该指令使 NGINX 服务器能够返回合适的媒体内容,利用范围请求以实现高效流式传输,并提升客户端的视频内容交付质量。

配置示例

location /vod {
    vod_media_set_map_uri /media/myvideos/;
}

确保指定的 URI 可访问并映射到现有的媒体文件,以防止 404 错误。

错误的映射可能会导致性能下降,原因是 URI 解析不正确。

检查 URI 映射中的尾随斜杠,因为它们可能影响路径解析。

← 返回所有指令