编码与格式 / 系统课时

设置默认轨道与元数据

设置默认轨道与元数据

同一个多轨文件即使包含正确的音频和字幕,播放器也可能显示“未知语言”或默认选中错误轨道。本课使用 -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 容器,能够稳定保存这些字段。

bash
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"

预期输出

text
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,除非业务确实需要。不同播放器对冲突标记的处理不一致,可能仍按轨道顺序或用户历史偏好选择。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设置默认轨道与元数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通