hls

在 NGINX RTMP 模块中启用对 MPEG-DASH 实时流媒体的支持。

语法hls on | off;
默认值off
上下文
参数1

说明

NGINX RTMP 模块中的 hls 指令用于为通过 NGINX 传输的媒体内容启用 HTTP Live Streaming (HLS)。该指令通过 HLS 协议将视频内容传送给客户端,这对自适应比特率流尤其有利。当在某个应用中设置了 hls 指令时,NGINX 会将传入的媒体流切分为片段,并通过 HLS 播放列表提供这些片段,使客户端能够通过按需下载这些片段来平滑播放流。

该 HLS 指令可以使用不同参数进行配置,包括用于指定每个片段持续时长的 hls_fragment 和用于确定播放列表中包含片段数量的 hls_playlist_length。生成的播放列表通常为 M3U8 格式,通过 HTTP 提供,支持 HLS 的各种媒体播放器均可访问,从而在不同设备和浏览器间实现广泛兼容。需要确保底层媒体格式受支持,并且运行时配置允许对 HLS 片段和播放列表所需的文件访问权限。

除了基本的 HLS 功能外,用户还应注意使用该指令在资源管理和流媒体质量调整方面的影响,因为这些设置可能会影响性能和带宽使用。因此,评估您的流媒体需求并相应配置 HLS 设置至关重要。

配置示例

application live {
    live on;
    hls on;
    hls_fragment 5s;
    hls_playlist_length 60s;
    hls_path /tmp/hls;
}

确保 hls_path 目录具有用于写入文件的正确权限。

为使其正常工作,hls 指令应在应用块内设置。

配置不当的片段长度可能导致资源过度使用或性能下降。

← 返回所有指令