record_append
在 NGINX RTMP 模块中,`record_append` 指令用于控制是否将新内容追加到现有的已录制流文件中。
NGINX RTMP module
语法record_append on | off;
默认值off
上下文
参数1
说明
NGINX RTMP 模块中的 record_append 指令用于指定新录制的数据是否应追加到现有文件,或在每次录制会话时创建新文件。启用后,它可以保持录制的连续性,将新的视频和音频内容与先前的录制合并到单个输出文件中。对于那些随着时间推送多个视频片段并希望将它们合并为一个便于存储和回放的完整文件的场景,这一点特别有用。
要使用此指令,必须在应用配置块的上下文中设置它。该指令接受一个布尔值,通常设置为 on 以激活,或 off 以停用。如果将指令设置为 on,每次新的录制会话会追加数据而不是覆盖现有数据。这种行为有助于维护视频文件的整体完整性,尤其是在内容实时生成的直播场景中。
当与指定要录制内容的 record 指令(例如,all 表示所有流)以及指示存储录制文件目录的 record_path 一起使用时,record_append 指令在录制流的文件管理中起着关键作用。重要的是确保为指定目录正确配置文件写入权限,以避免运行时错误,尤其是在同时录制多个流或会话时。
配置示例
application myapp {
live on;
record all;
record_path /tmp/av;
record_append on;
}⚠
确保记录路径对 NGINX 进程具有适当的写权限。
⚠
在追加时注意可能的文件大小限制;检查文件系统的限制。
⚠
在向文件追加时,录制的初始部分可能在流结束之前无法访问。