参数与调用公开全文含 AI 生成内容

用 ffprobe 查看视频尺寸、帧率和时长

用一条只读命令检查交付文件，再回到播放器检查画面。

约 6 分钟阅读 · 免费阅读

收到视频后，先确认它是不是约定的文件，再检查尺寸、帧率、时长和音轨。本教程使用 ffprobe 读取本地媒体信息，不转码，也不覆盖原视频。你需要已安装 FFmpeg 工具的一台电脑和一份可以检查的测试文件；命令中的 input.mp4 要替换为自己的路径。

1. 确认工具与检查对象

在终端运行下面的命令，确认系统能够找到 ffprobe。若提示命令不存在，先按照 FFmpeg 官方提供的下载或安装指引完成安装。记录工具版本，后续遇到字段或解码差异时便于排查。

ffprobe -version

检查对象应是实际准备交付的导出文件，而不是工程预览或聊天软件里的压缩副本。文件路径包含空格时保留双引号。先确认文件已经完整下载，未完成的传输也可能表现为读取失败，不要立刻认定编码有问题。

媒体文件检查顺序

以下命令选择第一个非封面类视频流，输出编码、宽高、平均帧率和容器时长。这里使用大写 V，是为了在选择视频流时排除附加封面等内容；复杂文件仍应进一步检查实际流列表。

ffprobe -v error -select_streams V:0 -show_entries stream=codec_name,width,height,avg_frame_rate:format=duration -of json "input.mp4"

输出是 JSON 文本，可以复制到检查记录中。字段缺失、为空或出现无法直接解释的值时，写“待核对”，不要为了表格完整自行填数字。命令正常返回，也不表示它已经替你判断了文件是否符合交付要求。

输出字段怎样读

如果短片应当包含声音，单独查看音频流。下面的命令会列出匹配的音频流信息；没有列出音轨时，先确认文件确实应该带声音，再判断是导出遗漏还是检查了错误版本。

ffprobe -v error -select_streams a -show_entries stream=index,codec_name,sample_rate,channels -of json "input.mp4"

需要了解多视频流、旋转信息或其他字段时，可以查看完整流与容器信息。不同文件的字段并不完全相同。手机竖拍文件可能涉及旋转信息，因此像素宽高与播放器最终显示方向需要一起看，不宜只根据两个数字决定画幅是否正确。

ffprobe -v error -show_streams -show_format -of json "input.mp4"

平均帧率是一个有用入口，但单个平均值不足以独立证明文件是恒定帧率，或每一帧的时间间隔都符合严格要求。遇到可变帧率、不同流时长或播放异常，应进一步检查时间戳与项目处理方式。

比较帧率时保留原始分数。约为 29.97 与 30 并不是同一个数，是否允许差异应按交付要求判断。若需要转换帧率，那是后续处理步骤，不属于本教程的只读检查；转换之后应对新文件重新读取并播放验收。

与交付要求对照（填写示例）

先检查路径和文件名，再确认文件大小与传输是否完成，然后看终端返回的错误。将错误和所执行的命令一起记录，分享时去掉个人目录、业务文件名等不必要信息。不要把随机网页上的修复命令直接用于唯一原件。

如果同一文件在播放器中能打开，但字段与预期不同，先查看完整流信息并核对工具版本。文件格式、封装和编码是不同层面的问题。无法解释的情况应交给对应技术人员进一步检查，不凭一个字段就重命名扩展名当作修复。

技术参数通过以后，仍然要从头到尾播放，检查黑帧、卡顿、错字、音量突变、字幕位置和标识。条件允许时在计划发布的设备或平台预览，确认展示结果，而不只看本机的媒体信息。

交付记录里分别填写“参数检查”和“观看检查”，附文件版本、检查日期及发现的问题。这样以后收到“声音不对”或“画面方向不对”的反馈，就能回到具体文件和具体环节，不必把全部素材重新猜一遍。

完成标准：保存检查命令与实际输出，能解释关键字段，能区分技术参数正确和内容观看合格。