MediaMTX中FFmpeg录制文件名格式化的技术实现

背景介绍

在视频流媒体服务器MediaMTX的使用过程中，很多开发者会遇到需要自定义FFmpeg录制文件名的需求。特别是在使用runOnReady钩子触发FFmpeg录制时，如何正确格式化输出文件名成为一个常见的技术挑战。

问题现象

当开发者尝试在MediaMTX的配置中使用类似${RTSP_PATH////_}的Bash变量替换语法来格式化文件名时，会发现替换并未生效。例如：

runOnReady: ffmpeg ... /recordings/${RTSP_PATH////_}_%Y-%m-%d_%H-%M-%S.mp4

实际生成的却是类似_2024-03-22_09-22-27.mp4的文件名，变量替换部分丢失了。

技术原理

MediaMTX为了保持跨平台兼容性（特别是Linux和Windows），没有使用完整的Bash shell环境来处理配置中的变量。其变量替换系统相对简单，仅支持基本的$VAR和${VAR}形式，不支持Bash特有的字符串操作功能。

解决方案

方案一：使用正确的变量名

首先确认使用的是正确的环境变量名。在MediaMTX的钩子脚本中，应该使用MTX_PATH而非RTSP_PATH。

方案二：使用外部脚本

更可靠的解决方案是将复杂的文件名处理逻辑放到外部脚本中：

1. 创建一个Bash脚本（如record.sh）：

#!/bin/bash
ffmpeg -loglevel verbose -use_wallclock_as_timestamps 1 \
       -rtsp_transport tcp -i rtsp://localhost:$RTSP_PORT/$RTSP_PATH \
       -fflags nobuffer -vcodec copy -f segment \
       -reset_timestamps 1 -strftime 1 -segment_time 30 \
       /recordings/${RTSP_PATH////_}_%Y-%m-%d_%H-%M-%S.mp4

2. 在MediaMTX配置中调用该脚本：

runOnReady: /path/to/record.sh

3. 确保脚本有执行权限：

chmod +x /path/to/record.sh

最佳实践

1. 保持简单：在YAML配置中尽量使用简单的变量引用
2. 复杂逻辑外置：将需要Bash高级功能的处理放到外部脚本
3. 测试验证：在部署前充分测试文件名生成逻辑
4. 日志记录：在脚本中添加日志输出以便调试

总结

MediaMTX出于跨平台考虑限制了配置中的变量处理能力，开发者可以通过将复杂逻辑转移到外部脚本的方式实现灵活的文件名格式化。这种方法不仅解决了当前问题，也使系统更易于维护和扩展。