编码与格式 / 系统课时
设置默认轨道与元数据
设置默认轨道与元数据
同一个多轨文件即使包含正确的音频和字幕,播放器也可能显示“未知语言”或默认选中错误轨道。本课使用 -metadata 与 -disposition 修改文件标题、轨道语言、轨道名称和默认标记,并用 ffprobe 验证结果。
学习目标
- 区分文件级元数据与流级元数据
- 为音频、字幕轨道设置语言、标题和默认标记
- 理解映射后输出流编号对元数据设置的影响
区分文件信息与轨道信息
文件级元数据描述整个容器,例如作品标题、作者或注释,写法是 -metadata key=value。流级元数据只作用于指定轨道,写法是 -metadata:s:<类型>:<序号> key=value,例如 -metadata:s:a:0 language=eng。
常用语言值通常使用三字母代码,如 eng、chi、jpn。容器和播放器对标签的支持并不完全一致,因此修改后必须探测输出,而不能只根据 FFmpeg 命令是否成功判断。
设置默认轨道标记
-disposition 控制播放器可见的轨道属性。default 表示默认候选,forced 常用于强制字幕,0 表示清除该轨道的全部 disposition。若希望只有第一路音频为默认,可对它设置 default,并对其他音频明确设置 0。

流说明符针对输出流解释。若前面通过 -map 调整了轨道顺序,a:0 表示映射后输出中的第一路音频,而不是源文件原来的第一路音频。这是批处理时最容易出现的错位原因。
完成元数据与默认轨道设置
下面生成一个双音轨测试文件,再复制所有流并写入文件标题、轨道标题、语言和默认标记。全程使用 Matroska 容器,能够稳定保存这些字段。
WORKDIR="<PATH>/ffmpeg-metadata-demo"
mkdir -p "$WORKDIR"
ffmpeg -y -f lavfi -i testsrc2=size=640x360:rate=25 -f lavfi -i sine=frequency=440:sample_rate=48000 -f lavfi -i sine=frequency=880:sample_rate=48000 -t 3 -map 0:v:0 -map 1:a:0 -map 2:a:0 -c:v mpeg4 -q:v 5 -c:a aac "$WORKDIR/source.mkv"
ffmpeg -y -i "$WORKDIR/source.mkv" -map 0 -c copy -metadata title="双语演示文件" -metadata:s:a:0 language=eng -metadata:s:a:0 title="English Stereo" -metadata:s:a:1 language=chi -metadata:s:a:1 title="中文立体声" -disposition:a:0 default -disposition:a:1 0 "$WORKDIR/tagged.mkv"
ffprobe -v error -select_streams a -show_entries stream=index:stream_tags=language,title:stream_disposition=default -of compact=p=0 "$WORKDIR/tagged.mkv"
ffprobe -v error -show_entries format_tags=title -of default=nw=1 "$WORKDIR/tagged.mkv"预期输出
index=1|disposition:default=1|tag:language=eng|tag:title=English Stereo
index=2|disposition:default=0|tag:language=chi|tag:title=中文立体声
TAG:title=双语演示文件字段排列可能随 FFmpeg 版本变化,但两路音频的语言、标题和 default 值应与上面一致。
处理字幕与已有标记
字幕同样使用类型说明符。例如 -metadata:s:s:0 language=chi 设置第一路字幕语言,-disposition:s:0 forced 将其标记为强制字幕。若要保留已有标记并增加一个属性,可使用 +forced;若要移除单个属性,可使用 -forced。
重新封装时,某些输出格式可能不支持源容器中的全部元数据或附件。MP4、Matroska 和 MPEG-TS 的能力不同,发现字段丢失时应先确认目标容器是否支持,而不是反复修改同一条命令。
注意:不要让多条同类型轨道同时带有
default,除非业务确实需要。不同播放器对冲突标记的处理不一致,可能仍按轨道顺序或用户历史偏好选择。