hls_sync
`hls_sync` 指令在 NGINX RTMP 模块中配置 HLS 输出流的同步设置。
NGINX RTMP module
语法hls_sync on | off;
默认值off
上下文
参数1
说明
NGINX RTMP 模块中的 hls_sync 指令用于控制 HLS (HTTP Live Streaming) 段在一系列流之间应如何同步。启用后，该指令有助于确保 HLS 客户端能够回放流而不会出现播放时间上的差异，这对于直播场景至关重要。该指令通过调整传入 HLS 段的时间戳来维持分布式回放的一致性，特别适用于多码率流或可能聚合来自多个源的段的场景。
hls_sync 的参数是一个布尔值，将其设置为 'on' 可激活 HLS 流的同步策略。如果保持为 'off' 或未指定，NGINX 将不会对 HLS 段执行任何同步，这可能导致播放不同步，尤其在网络状况不稳定或客户端能力不同的情况下。默认行为因此是不进行同步，除非通过该指令显式开启。
通过实现 hls_sync，管理员可以改善观看体验，提供更平滑的回放并减少由流段之间时间偏移引起的中断。这在观众在不同流质量或来源之间切换的场景中尤为重要。该指令通常与其他与 HLS 相关的设置一起使用，以优化直播活动或广播应用的整体流配置。
配置示例
hls {
hls_sync on;
hls_fragment 5s;
hls_playlist_length 60s;
}⚠
对于需要多个分段之间精确同步的应用，确保 hls_sync 设置为 'on'。
⚠
如果其他 HLS 设置与同步要求不兼容，错误配置 hls_sync 可能导致播放问题。