record_suffix

`record_suffix` 指令在 NGINX RTMP 模块中指定一个后缀,用于根据当前时间戳追加到录制的视频文件上。

语法record_suffix string;
默认值none
上下文
参数1

说明

record_suffix 指令用于 NGINX RTMP 模块的录制场景,特别是在流正在被录制时。当流发布时,该指令允许配置一个将被添加到录制文件名的后缀。此功能对于区分同一流的多次录制尤其有用,用户可以通过包含唯一的时间戳或标识符来避免文件名冲突。

该指令接受一个字符串参数,作为录制文件的后缀。NGINX RTMP 模块在文件录制过程中使用该后缀;因此,录制的文件将以 <stream-name>_<timestamp><record_suffix>.flv 的格式命名。借助此功能,用户可以有效地管理录制的流,尤其是在来自不同会话或不同实例的多次录制同时发生的场景中。

例如,如果某个流在某一时间发布,且 record_suffix 设置为 _v1,那么生成的录制文件可能被命名为 liveStream_1634920810_v1.flv。这有助于识别和排序录制的媒体文件,尤其在生产环境中大量流可能同时发生时。

配置示例

application my_app {
    live on;
    record all;
    record_suffix _%Y%m%d_%H%M%S;
    record_path /var/www/html/records;
}

确保为后缀使用有效格式;无效字符可能导致意外的文件名。

如果启用了 record_unique,后缀可能不会按预期工作,因为文件命名被覆盖。

录制文件会覆盖具有相同名称的现有文件,除非使用唯一标识符。请注意覆盖风险。

← 返回所有指令