record_unique

NGINX RTMP 模块中的 'record_unique' 指令会在录制的流文件名中追加唯一的时间戳,从而防止被覆盖。

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

说明

'record_unique' 指令用于 NGINX RTMP 模块的实时流媒体应用场景。当启用时,该指令通过在文件名末尾追加当前时间戳来修改录制的流文件的命名规则。在可能同时录制多个同名流的情况下,这一点尤其有用。若不使用此指令,新录制的流可能会覆盖先前的录制,导致数据丢失。\n\n该指令接受一个参数,通常为 on 以启用唯一命名功能。设置为 'on' 时,每次录制流时都会基于当前时间生成唯一名称,从而确保之前的流文件保持完整。该命名约定便于根据录制时间进行识别,这对于归档和检索非常重要。\n\n该指令的实现依赖于 RTMP 模块流录制功能的核心机制。它与其他录制相关的指令(如 'record' 和 'record_path')紧密配合,构成一个用于实时广播场景中有效处理流的完整配置。在实时数据完整性至关重要的用例中,使用 'record_unique' 能显著提升录制媒体的可靠性。

配置示例

application myapp {
    live on;
    record all;
    record_path /var/www/html/records;
    record_unique on;
}

确保记录路径可写;否则,录制可能会失败,并且不会提供清晰的错误信息。

注意,启用 'record_unique' 可能导致录制目录中累计大量文件,可能需要额外的管理以避免磁盘空间问题。

← 返回所有指令