MediaMTX项目中Opus音频流录制时间戳异常问题分析

问题概述

在MediaMTX 1.10.0版本中，用户发现当录制Opus编码的纯音频RTSP流时，生成的录制文件时间戳出现了异常现象。具体表现为：虽然配置了1分钟的片段时长，但生成的文件名时间戳却以2分钟的间隔递增，而实际文件内容时长仍为1分钟。

问题复现环境

该问题出现在Linux amd64 Docker环境中，使用以下配置参数：

• 启用录制功能(record: yes)
• 使用fMP4格式(recordFormat: fmp4)
• 设置片段时长为1分钟(recordSegmentDuration: 1m)
• 部分时长为1秒(recordPartDuration: 1s)

当通过FFmpeg发布Opus编码的音频流时，例如使用命令ffmpeg -i in.wav -f rtsp -c:a libopus rtsp://media-server:8554/streamname，就会出现时间戳异常问题。

技术分析

时间戳生成机制

MediaMTX在录制流媒体时，会根据配置的recordPath参数生成文件名，其中包含时间戳信息。正常情况下，这些时间戳应该与实际录制时间一致，按照配置的片段时长均匀递增。

Opus编码的特殊性

Opus是一种高效的音频编码格式，广泛应用于实时通信和流媒体领域。与其他编码格式(如mu-law)不同，Opus编码具有以下特点：

1. 支持可变比特率
2. 内置时间戳处理机制
3. 通常使用48kHz采样率

问题根源

经过分析，问题出在时间戳处理逻辑上。当处理Opus编码流时，MediaMTX错误地将时间戳计算为实际时间的两倍，导致文件名中的时间戳间隔变为2分钟，而实际内容仍保持1分钟的片段长度。

临时解决方案

在官方修复前，用户提出了一个巧妙的临时解决方案，利用MediaMTX的hook功能手动修正文件名：

runOnRecordSegmentCreate: sh -c 'date -u +%Y-%m-%d_%H-%M-%S-%s > $MTX_SEGMENT_PATH.timestamp'
runOnRecordSegmentComplete: sh -c 'mv $MTX_SEGMENT_PATH $(dirname $MTX_SEGMENT_PATH)/$(head -n 1 $MTX_SEGMENT_PATH.timestamp).mp4 && rm $MTX_SEGMENT_PATH.timestamp'

这个方法通过创建临时时间戳文件，在片段完成时重命名文件，确保文件名反映正确的录制时间。

官方修复

该问题已在MediaMTX 1.11.0版本中得到修复。修复涉及对时间戳计算逻辑的调整，确保无论使用何种音频编码格式，文件名中的时间戳都能正确反映实际录制时间。

总结

这个案例展示了流媒体服务器在处理不同编码格式时可能遇到的时间戳同步问题。对于开发者而言，需要特别注意不同编码格式的时间戳处理机制差异；对于使用者，了解这类问题的临时解决方案有助于在等待官方修复期间维持系统正常运行。