mpv 编码模式详解从 --o 开关到编解码器参数与元数据管理的完整指南【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpvmpv 除了播放还内置了一套基于 libavformat/libavcodec 的转码muxing/encoding能力只需用--o输出文件开启编码模式就能在播放管线内完成“解码 → 重编码 → 封装”的全流程。本篇基于 mpv 官方手册中的 ENCODING 章节encode.rst展开完整覆盖--o、--of、--ofopts、--ovc、--ovcopts、--oac、--oacopts、--orawts及元数据控制等全部选项并结合 common/encode_lavc.c 等源码逐层剖析其解析逻辑、时间戳处理与元数据写入顺序最后给出仓库自带的编码配置文件 etc/encoding-profiles.conf 的实战用法。一、进入编码模式--o 开关与初始化流程--ofilename启用编码模式并指定输出文件名。这是 mpv 转码功能的“总开关”——没有它其余所有--o*选项都不起作用。从源码结构看这一开关的行为比想象中更“特殊”。在 common/encode_lavc.c 的选项定义中--o携带了M_OPT_NOCFG | M_OPT_PRE_PARSE | M_OPT_FILE三个标志M_OPT_PRE_PARSE预解析选项。mpv 在正式解析命令行之前就先识别出--o因此编码模式可以在播放任何内容前就已确定编码器初始化也能赶在加载文件之前完成M_OPT_NOCFG该选项不允许写在配置文件中因为输出文件通常应随每次调用显式指定M_OPT_FILE值会按路径规则做扩展如~、{}目录替换。当命令行中出现--o且非空时player/main.c 会在播放核心初始化阶段调用encode_lavc_init()创建编码上下文失败则直接报错退出打印 Encoding initialization failed.。encode_lavc_init()common/encode_lavc.c内部的关键细节值得注意管道输出支持libavformat 的 avio 不支持把-当作 stdoutmpv 在这里做了一层映射——--o-会被内部改写成pipe:1因此可以直接把编码结果打到标准输出mpv --o- in.mkv | cat out.mkv容器格式判定若指定了--of调用av_guess_format(格式名, 文件名, NULL)显式查找否则仅凭输出文件名让 libavformat 按扩展名自动探测。找不到格式会报 format not found 并初始化失败文件名处理经过mp_get_user_path()展开后再写入 muxer 的url字段。初始化完成后编码复用 mpv 既有的音视频播放管线视频帧经由 VO 层的vo_lavc、音频帧经由 AO 层的ao_lavc被送入编码器encode_lavc_context结构体定义于 common/encode_lavc.h以互斥锁保护所有共享状态各入口函数在注释中明确说明“播放核心调用会自动加锁ao_lavc/vo_lavc 必须手动加锁”。二、封装格式控制--of 与 --ofopts--offormat指定输出容器格式覆盖基于--o文件名扩展名的自动探测。执行--ofhelp可列出全部支持的格式。--ofoptsoptions为 libavformat 的封装器muxer指定格式级选项执行--ofoptshelp可列出全部支持的选项。这是一个 key/value 列表选项list option详细规则见 List Options 一节。--ofopts-addoption把参数给出的选项追加到现有列表末尾。一次传入多个选项目前仍可行但已废弃。--ofopts完全清空选项列表。--ofhelp与--ofoptshelp的实现位于encode_lavc_showhelp()common/encode_lavc.c前者通过av_muxer_iterate()遍历 libavformat 注册的所有 muxer 并打印--ofname形式列表后者用encode_lavc_printoptions()遍历AVOption树按AV_OPT_FLAG_ENCODING_PARAM过滤出编码参数及其所属 unit 下的常量取值。也就是说你能看到的可选值完全取决于编译 mpv 时所链接的 FFmpeg/libav 库版本这是“以当前仓库实际内容为准”的重要前提。几个典型的格式级选项可在--ofoptshelp输出中核对movflagsfaststart为 MP4/MOV 将 moov atom 前置等效于传统qt-faststart工具可加速流式播放时的 seeketc/encoding-profiles.conf 中即以注释形式给出DVD 封装的packetsize2048、muxrate10080000见 etc/encoding-profiles.conf 的enc-to-dvdpal配置。三、视频编码--ovc 与 --ovcopts--ovccodec指定输出视频编解码器。执行--ovchelp可列出全部受支持的编码器。--ovcoptsoptions为 libavcodec 的视频编码器指定选项--ovcoptshelp同样可用。这也是 key/value 列表选项详见 List Options。手册给出的两个经典示例--ovcmpeg4 --ovcoptsqscale5以恒定量化系数quantizer scale5 进行 MPEG-4 编码。qscale值越小画质越高、码率越大属于“恒定质量”模式--ovclibx264 --ovcoptscrf23以 VBR 质量因子 CRF 23 进行 H.264 编码。CRF 是 x264 的“恒定质量”质量因子默认 23 即为平衡点数值越小质量越高。--ovcopts-addoption向选项列表追加一个选项多值一次传入目前仍可行但已废弃。--ovcopts完全清空选项列表。需要强调的是列表选项的覆盖语义直接写--ovcopts...是整体替换--ovcopts-add才是追加。这一区别在叠加编码 profile 时尤为关键见第七节的实际用法。源码层面--ovc被解析为struct encode_opts的vcodec字符串字段common/encode_lavc.c 中的encode_opts结构随后由vo_lavc按 FFmpeg 编码器参数逐条应用。四、音频编码--oac 与 --oacopts--oaccodec指定输出音频编解码器。执行--oachelp可列出全部受支持的编码器。--oacoptsoptions为 libavcodec 的音频编码器指定选项--oacoptshelp同样可用。key/value 列表选项规则同--ovcopts。手册示例--oaclibmp3lame --oacoptsb128000选择 128 kbps 的 MP3 编码b即 target bitrate。--oacopts-addoption追加选项到列表同上多值一次性传入已废弃。--oacopts完全清空列表。音频侧可用的质量选项因编码器而异例如b比特率、qscale恒定量化、compression_level负值越大越好等具体请以--oacoptshelp在当前构建上输出的实际条目为准。五、--orawts时间戳直通模式与不连续性修正--orawts把输入的 pts 原样复制到输出视频中部分输出容器格式不支持例如 AVI。在该模式下不修复任何不连续性discontinuity所有 pts 均按原值透传。此模式下切勿向后 seek也不要使用多个输入文件为什么默认模式下需要“修复不连续性”因为 mpv 的编码是“边播放边编码”用户可能随时 seek、暂停、甚至中途载入其他片段导致送入编码器的视频 pts 序列出现跳跃。默认非 raw模式下video/out/vo_lavc.c 的逻辑是维护一个discontinuity_pts_offset定义于 common/encode_lavc.h 的 anti discontinuity mode 字段首帧时以next_in_pts - pts计算偏移量后续每帧若发现pts offset与期望的下一帧 pts 相差超过 30 秒即判定为意外不连续性打印 detected an unexpected discontinuity (pts jumped by %f seconds) 警告并重新校准偏移同时按编码器 timebase 推算下一帧期望 pts保证输出时间戳单调递增。而--orawts直接跳过上述所有修正源码中即if (!enc-options-rawts)的两个分支pts 原封不动写入输出。它适用于输入 pts 已经精确、且下游依赖原始时间戳的场景代价正如手册所警告某些容器如 AVI的封装器无法接受任意 pts写出的文件可能损坏或无法播放一旦向后 seek 或多输入拼接输出的时间戳序列会出现回退/大跳变绝大多数播放器无法处理。六、元数据控制复制、设置与剔除--ocopy-metadatayes|no编码时是否把输入文件的元数据复制到输出文件默认yes。源码中默认值同样明确——encode_config的 defaults 里.copy_metadata truecommon/encode_lavc.c。--oset-metadatametadata-tag[,metadata-tag,...]指定要写入输出文件的元数据keyvalue 列表。不同输出格式支持的键不同MatroskaMKV和 FLAC 允许几乎任意的键而 MP4 和 MP3 的支持范围要窄得多。示例--oset-metadatatitleOutput title,commentAnother tag会为输出文件添加标题和注释标签。--oremove-metadatametadata-tag[,metadata-tag,...]指定在从输入复制到输出时排除的元数据键。这是字符串列表选项注意与--oset-metadata的 key/value 列表不同。示例--oremove-metadatacomment,genre将排除 comment 与 genre 两个标签的复制。三者如何协同encode_lavc_set_metadata()common/encode_lavc.c的写入顺序是若copy_metadata为真先整体复制输入标签否则从空标签集开始逐个应用--oset-metadata的键值同名键会被新值覆盖最后按--oremove-metadata的键逐一删除。也就是说--oset-metadata优先级高于复制而--oremove-metadata拥有最终否决权。每个设置/删除动作都会打 verbose 日志setting metadata value .../removing metadata key ...可通过--really-quiet/日志等级观察。七、实战使用仓库自带的编码 Profilempv 仓库内置了一份编码 profile 参考文件 etc/encoding-profiles.conf它按四类组织恰好演示了上文所有选项的组合方式enc-a-*音频编码器 合理默认值。如enc-a-mp3oaclibmp3lame, oacoptsb128k、enc-a-aacoaclibfdk_aac,aac, oacoptsb96k、enc-a-opus强制 48kHz 采样率 b96kenc-v-*视频编码器 合理默认值。如enc-v-h264ovclibx264, ovcoptspresetmedium,crf23,threads0、enc-v-vp9ovclibvpx-vp9crf18等enc-f-*封装格式 搭配好的音视频组合。如enc-f-mp4H.264AACMP4 容器、enc-f-webmVP9Opus、enc-f-aviMPEG-4MP3enc-to-*面向特定目标设备的完整参数包如 DVD-Video PAL/NTSC 的码率/ GOP/包大小设置。文件头部注释etc/encoding-profiles.conf给出的三条命令就是最直接的实战模板# 完整设备 profile转 DVD-Video PAL mpv --profileenc-to-dvdpal --ooutfile.mpg infile.mkv # 格式 profile 视频滤镜 mpv --profileenc-f-avi --vffps30 --ooutfile.avi infile.mkv # 视频/音频 profile 叠加并用 -add 追加个别选项 mpv --profileenc-v-mpeg4 --ovcopts-addqscale7 --profileenc-a-mp3 \ --oacopts-addb320k --ooutfile.avi infile.mkv第三条命令直观体现了“整体替换 vs 追加”的语义profile 先设置了ovcoptsqscale4随后--ovcopts-addqscale7追加的条目在后生效实现了对 profile 默认值的局部覆盖。注意该文件在注释中说明这些 profile 在新版 mpv 中默认不再随安装自动加载属于历史参考可自行放入配置目录使用。八、编码结果的验证结束时打印的统计信息编码收尾时encode_lavc_free()common/encode_lavc.c会做一次完整性检查并输出统计若整个过程中一个字节都没写header_written为假报 no data written to target file 并判定失败——这通常意味着输入流类型与编码器不匹配或参数错误正常结束时调用av_write_trailer()写文件尾随后打印三条 INFO 日志video: encoded %lld bytes/audio: encoded %lld bytes各码流写入字节数统计在每次av_interleaved_write_frame()成功写包时按AVPacket-size累加muxing overhead %lld bytes用 avio 总字节数减去音视频字节数得到的容器开销。这些信息为“编码结果是否符合预期”提供了可验证的依据视频字节数明显偏大时可回头检查--ovcopts的质量/码率参数muxing overhead 异常大时可排查--ofopts中的容器设置。小结mpv 的编码模式把 FFmpeg 的封装与编码能力接入了自己的播放管线--o预解析并初始化 muxer--of/--ofopts控制容器--ovc/--ovcopts与--oac/--oacopts控制两类编码器均支持help自检与-add/的列表操作语义--orawts关闭 pts 不连续性修正--ocopy-metadata/--oset-metadata/--oremove-metadata按“复制 → 设置 → 剔除”的确定顺序管理元数据。配合etc/encoding-profiles.conf中的 profile 体系即可完成从“一条命令转 DVD 光盘参数”到“自定义 x264 CRF 转 MP4”的完整转码工作流。所有help输出的可用格式与选项最终以当前构建所链接的 libavformat/libavcodec 为准。【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 mpv 编码模式详解：从 --o 开关到编解码器参数与元数据管理的完整指南
mpv 编码模式详解从 --o 开关到编解码器参数与元数据管理的完整指南【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpvmpv 除了播放还内置了一套基于 libavformat/libavcodec 的转码muxing/encoding能力只需用--o输出文件开启编码模式就能在播放管线内完成“解码 → 重编码 → 封装”的全流程。本篇基于 mpv 官方手册中的 ENCODING 章节encode.rst展开完整覆盖--o、--of、--ofopts、--ovc、--ovcopts、--oac、--oacopts、--orawts及元数据控制等全部选项并结合 common/encode_lavc.c 等源码逐层剖析其解析逻辑、时间戳处理与元数据写入顺序最后给出仓库自带的编码配置文件 etc/encoding-profiles.conf 的实战用法。一、进入编码模式--o 开关与初始化流程--ofilename启用编码模式并指定输出文件名。这是 mpv 转码功能的“总开关”——没有它其余所有--o*选项都不起作用。从源码结构看这一开关的行为比想象中更“特殊”。在 common/encode_lavc.c 的选项定义中--o携带了M_OPT_NOCFG | M_OPT_PRE_PARSE | M_OPT_FILE三个标志M_OPT_PRE_PARSE预解析选项。mpv 在正式解析命令行之前就先识别出--o因此编码模式可以在播放任何内容前就已确定编码器初始化也能赶在加载文件之前完成M_OPT_NOCFG该选项不允许写在配置文件中因为输出文件通常应随每次调用显式指定M_OPT_FILE值会按路径规则做扩展如~、{}目录替换。当命令行中出现--o且非空时player/main.c 会在播放核心初始化阶段调用encode_lavc_init()创建编码上下文失败则直接报错退出打印 Encoding initialization failed.。encode_lavc_init()common/encode_lavc.c内部的关键细节值得注意管道输出支持libavformat 的 avio 不支持把-当作 stdoutmpv 在这里做了一层映射——--o-会被内部改写成pipe:1因此可以直接把编码结果打到标准输出mpv --o- in.mkv | cat out.mkv容器格式判定若指定了--of调用av_guess_format(格式名, 文件名, NULL)显式查找否则仅凭输出文件名让 libavformat 按扩展名自动探测。找不到格式会报 format not found 并初始化失败文件名处理经过mp_get_user_path()展开后再写入 muxer 的url字段。初始化完成后编码复用 mpv 既有的音视频播放管线视频帧经由 VO 层的vo_lavc、音频帧经由 AO 层的ao_lavc被送入编码器encode_lavc_context结构体定义于 common/encode_lavc.h以互斥锁保护所有共享状态各入口函数在注释中明确说明“播放核心调用会自动加锁ao_lavc/vo_lavc 必须手动加锁”。二、封装格式控制--of 与 --ofopts--offormat指定输出容器格式覆盖基于--o文件名扩展名的自动探测。执行--ofhelp可列出全部支持的格式。--ofoptsoptions为 libavformat 的封装器muxer指定格式级选项执行--ofoptshelp可列出全部支持的选项。这是一个 key/value 列表选项list option详细规则见 List Options 一节。--ofopts-addoption把参数给出的选项追加到现有列表末尾。一次传入多个选项目前仍可行但已废弃。--ofopts完全清空选项列表。--ofhelp与--ofoptshelp的实现位于encode_lavc_showhelp()common/encode_lavc.c前者通过av_muxer_iterate()遍历 libavformat 注册的所有 muxer 并打印--ofname形式列表后者用encode_lavc_printoptions()遍历AVOption树按AV_OPT_FLAG_ENCODING_PARAM过滤出编码参数及其所属 unit 下的常量取值。也就是说你能看到的可选值完全取决于编译 mpv 时所链接的 FFmpeg/libav 库版本这是“以当前仓库实际内容为准”的重要前提。几个典型的格式级选项可在--ofoptshelp输出中核对movflagsfaststart为 MP4/MOV 将 moov atom 前置等效于传统qt-faststart工具可加速流式播放时的 seeketc/encoding-profiles.conf 中即以注释形式给出DVD 封装的packetsize2048、muxrate10080000见 etc/encoding-profiles.conf 的enc-to-dvdpal配置。三、视频编码--ovc 与 --ovcopts--ovccodec指定输出视频编解码器。执行--ovchelp可列出全部受支持的编码器。--ovcoptsoptions为 libavcodec 的视频编码器指定选项--ovcoptshelp同样可用。这也是 key/value 列表选项详见 List Options。手册给出的两个经典示例--ovcmpeg4 --ovcoptsqscale5以恒定量化系数quantizer scale5 进行 MPEG-4 编码。qscale值越小画质越高、码率越大属于“恒定质量”模式--ovclibx264 --ovcoptscrf23以 VBR 质量因子 CRF 23 进行 H.264 编码。CRF 是 x264 的“恒定质量”质量因子默认 23 即为平衡点数值越小质量越高。--ovcopts-addoption向选项列表追加一个选项多值一次传入目前仍可行但已废弃。--ovcopts完全清空选项列表。需要强调的是列表选项的覆盖语义直接写--ovcopts...是整体替换--ovcopts-add才是追加。这一区别在叠加编码 profile 时尤为关键见第七节的实际用法。源码层面--ovc被解析为struct encode_opts的vcodec字符串字段common/encode_lavc.c 中的encode_opts结构随后由vo_lavc按 FFmpeg 编码器参数逐条应用。四、音频编码--oac 与 --oacopts--oaccodec指定输出音频编解码器。执行--oachelp可列出全部受支持的编码器。--oacoptsoptions为 libavcodec 的音频编码器指定选项--oacoptshelp同样可用。key/value 列表选项规则同--ovcopts。手册示例--oaclibmp3lame --oacoptsb128000选择 128 kbps 的 MP3 编码b即 target bitrate。--oacopts-addoption追加选项到列表同上多值一次性传入已废弃。--oacopts完全清空列表。音频侧可用的质量选项因编码器而异例如b比特率、qscale恒定量化、compression_level负值越大越好等具体请以--oacoptshelp在当前构建上输出的实际条目为准。五、--orawts时间戳直通模式与不连续性修正--orawts把输入的 pts 原样复制到输出视频中部分输出容器格式不支持例如 AVI。在该模式下不修复任何不连续性discontinuity所有 pts 均按原值透传。此模式下切勿向后 seek也不要使用多个输入文件为什么默认模式下需要“修复不连续性”因为 mpv 的编码是“边播放边编码”用户可能随时 seek、暂停、甚至中途载入其他片段导致送入编码器的视频 pts 序列出现跳跃。默认非 raw模式下video/out/vo_lavc.c 的逻辑是维护一个discontinuity_pts_offset定义于 common/encode_lavc.h 的 anti discontinuity mode 字段首帧时以next_in_pts - pts计算偏移量后续每帧若发现pts offset与期望的下一帧 pts 相差超过 30 秒即判定为意外不连续性打印 detected an unexpected discontinuity (pts jumped by %f seconds) 警告并重新校准偏移同时按编码器 timebase 推算下一帧期望 pts保证输出时间戳单调递增。而--orawts直接跳过上述所有修正源码中即if (!enc-options-rawts)的两个分支pts 原封不动写入输出。它适用于输入 pts 已经精确、且下游依赖原始时间戳的场景代价正如手册所警告某些容器如 AVI的封装器无法接受任意 pts写出的文件可能损坏或无法播放一旦向后 seek 或多输入拼接输出的时间戳序列会出现回退/大跳变绝大多数播放器无法处理。六、元数据控制复制、设置与剔除--ocopy-metadatayes|no编码时是否把输入文件的元数据复制到输出文件默认yes。源码中默认值同样明确——encode_config的 defaults 里.copy_metadata truecommon/encode_lavc.c。--oset-metadatametadata-tag[,metadata-tag,...]指定要写入输出文件的元数据keyvalue 列表。不同输出格式支持的键不同MatroskaMKV和 FLAC 允许几乎任意的键而 MP4 和 MP3 的支持范围要窄得多。示例--oset-metadatatitleOutput title,commentAnother tag会为输出文件添加标题和注释标签。--oremove-metadatametadata-tag[,metadata-tag,...]指定在从输入复制到输出时排除的元数据键。这是字符串列表选项注意与--oset-metadata的 key/value 列表不同。示例--oremove-metadatacomment,genre将排除 comment 与 genre 两个标签的复制。三者如何协同encode_lavc_set_metadata()common/encode_lavc.c的写入顺序是若copy_metadata为真先整体复制输入标签否则从空标签集开始逐个应用--oset-metadata的键值同名键会被新值覆盖最后按--oremove-metadata的键逐一删除。也就是说--oset-metadata优先级高于复制而--oremove-metadata拥有最终否决权。每个设置/删除动作都会打 verbose 日志setting metadata value .../removing metadata key ...可通过--really-quiet/日志等级观察。七、实战使用仓库自带的编码 Profilempv 仓库内置了一份编码 profile 参考文件 etc/encoding-profiles.conf它按四类组织恰好演示了上文所有选项的组合方式enc-a-*音频编码器 合理默认值。如enc-a-mp3oaclibmp3lame, oacoptsb128k、enc-a-aacoaclibfdk_aac,aac, oacoptsb96k、enc-a-opus强制 48kHz 采样率 b96kenc-v-*视频编码器 合理默认值。如enc-v-h264ovclibx264, ovcoptspresetmedium,crf23,threads0、enc-v-vp9ovclibvpx-vp9crf18等enc-f-*封装格式 搭配好的音视频组合。如enc-f-mp4H.264AACMP4 容器、enc-f-webmVP9Opus、enc-f-aviMPEG-4MP3enc-to-*面向特定目标设备的完整参数包如 DVD-Video PAL/NTSC 的码率/ GOP/包大小设置。文件头部注释etc/encoding-profiles.conf给出的三条命令就是最直接的实战模板# 完整设备 profile转 DVD-Video PAL mpv --profileenc-to-dvdpal --ooutfile.mpg infile.mkv # 格式 profile 视频滤镜 mpv --profileenc-f-avi --vffps30 --ooutfile.avi infile.mkv # 视频/音频 profile 叠加并用 -add 追加个别选项 mpv --profileenc-v-mpeg4 --ovcopts-addqscale7 --profileenc-a-mp3 \ --oacopts-addb320k --ooutfile.avi infile.mkv第三条命令直观体现了“整体替换 vs 追加”的语义profile 先设置了ovcoptsqscale4随后--ovcopts-addqscale7追加的条目在后生效实现了对 profile 默认值的局部覆盖。注意该文件在注释中说明这些 profile 在新版 mpv 中默认不再随安装自动加载属于历史参考可自行放入配置目录使用。八、编码结果的验证结束时打印的统计信息编码收尾时encode_lavc_free()common/encode_lavc.c会做一次完整性检查并输出统计若整个过程中一个字节都没写header_written为假报 no data written to target file 并判定失败——这通常意味着输入流类型与编码器不匹配或参数错误正常结束时调用av_write_trailer()写文件尾随后打印三条 INFO 日志video: encoded %lld bytes/audio: encoded %lld bytes各码流写入字节数统计在每次av_interleaved_write_frame()成功写包时按AVPacket-size累加muxing overhead %lld bytes用 avio 总字节数减去音视频字节数得到的容器开销。这些信息为“编码结果是否符合预期”提供了可验证的依据视频字节数明显偏大时可回头检查--ovcopts的质量/码率参数muxing overhead 异常大时可排查--ofopts中的容器设置。小结mpv 的编码模式把 FFmpeg 的封装与编码能力接入了自己的播放管线--o预解析并初始化 muxer--of/--ofopts控制容器--ovc/--ovcopts与--oac/--oacopts控制两类编码器均支持help自检与-add/的列表操作语义--orawts关闭 pts 不连续性修正--ocopy-metadata/--oset-metadata/--oremove-metadata按“复制 → 设置 → 剔除”的确定顺序管理元数据。配合etc/encoding-profiles.conf中的 profile 体系即可完成从“一条命令转 DVD 光盘参数”到“自定义 x264 CRF 转 MP4”的完整转码工作流。所有help输出的可用格式与选项最终以当前构建所链接的 libavformat/libavcodec 为准。【免费下载链接】mpv Command line media player项目地址: https://gitcode.com/GitHub_Trending/mp/mpv创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考