hls_fragment_naming
设置由 NGINX RTMP 模块生成的 HLS 片段文件的命名方案。
NGINX RTMP module
语法hls_fragment_naming format;
默认值none
上下文
参数1
说明
hls_fragment_naming 指令用于定义 NGINX RTMP 模块中 HLS 片段名称的构造方式。默认情况下,片段文件根据时间戳和序列号生成。根据提供的参数,该指令可以强制使用自定义命名约定,该约定可以根据需求包含时间戳或序列号。这在客户端或外部系统依赖特定文件命名结构以正确识别和访问这些片段的场景中特别有用。
该指令的参数规范允许使用单个参数来表示命名格式。常见格式可能包括使用占位符来表示流名称、时间戳和序列号。该指令的行为可用于为每个片段提供唯一标识符,以便更易于访问和管理,或者采用更传统的命名方案以便传统系统更容易处理。此外,应谨慎选择命名约定以避免冲突,并确保服务器端文件易于访问和管理。
在配置 hls_fragment_naming 时,务必验证指定的命名模式与目标播放场景相匹配。此外,了解该命名方式如何融入整体的文件管理、清理和传递流程将有助于更高效地进行设置。
配置示例
hls_fragment_naming 'fragment-$seq-$timestamp.ts';
⚠
确保命名格式唯一以避免文件被覆盖。
⚠
使用不正确的占位符可能导致片段生成出现错误。
⚠
不验证文件路径可能导致运行时错误。