音频开发 / 系统课时
用命令行检查音频流参数
用命令行检查音频流参数
面对来源未知的音频文件,先不要急着写代码解析。FFmpeg 适合快速查看媒体流并做转换,ffprobe 更适合输出结构化参数。本篇用一个可重复生成的测试音频,检查采样率、声道、采样格式、编码格式、码率和时长,并说明这些字段如何用于后续排障。
学习目标
- 用 FFmpeg 快速确认音频流是否能被识别
- 用 ffprobe 提取可脚本处理的音频参数
- 判断采样率、声道、采样格式、编码、码率和时长是否彼此一致
先确认工具可用
下面命令适用于 macOS、Linux 或 WSL。版本号会因安装环境不同而变化。
ffmpeg -version | head -n 1
ffprobe -version | head -n 1预期输出
ffmpeg version <VERSION> ...
ffprobe version <VERSION> ...若命令不存在,先修复 FFmpeg 安装或 PATH,不要继续分析文件参数;否则后面的失败会把“工具不可用”和“媒体有问题”混在一起。
生成一个已知参数的测试文件
先生成 1 秒、48 kHz、双声道、16 位 PCM WAV。把 <PATH> 替换成实际可写目录;实际路径因环境不同而不同。
mkdir -p "<PATH>"
ffmpeg -hide_banner -loglevel error -f lavfi -i "sine=frequency=1000:sample_rate=48000:duration=1" -ac 2 -c:a pcm_s16le -y "<PATH>/tone.wav"预期结果
命令正常结束且没有错误输出,<PATH>/tone.wav 被创建。这个文件的参数是我们主动指定的,因此适合用来验证后续检查命令是否读对:采样率应为 48000 Hz,声道数为 2,编码为 pcm_s16le,样本格式应为 16 位有符号整数。
用 FFmpeg 快速扫一眼音频流
FFmpeg 的输入探测信息适合人工快速确认“能不能识别”和“主要参数是否合理”。下面只保留时长与第一条输入音频流,避免输出流和进度日志干扰。
ffmpeg -hide_banner -i "<PATH>/tone.wav" -f null - 2>&1 | grep -E 'Duration:|Stream #0:0:' | head -n 2预期输出
Duration: 00:00:01.00, bitrate: 1536 kb/s
Stream #0:0: Audio: pcm_s16le (<CODEC_TAG>), 48000 Hz, stereo, s16, 1536 kb/s<CODEC_TAG> 的具体文本可能随 FFmpeg 版本和容器解析方式不同,但 pcm_s16le、48000 Hz、stereo、s16 与 1536 kb/s 应与生成参数一致。对于 PCM,音频码率可直接核对为 48000 × 2 × 16 = 1536000 bit/s,也就是 1536 kb/s。
用 ffprobe 取得可脚本处理的字段
需要批量校验或把结果送进程序时,应优先使用 ffprobe。-select_streams a:0 只选择第一条音频流,-show_entries 则限制字段,避免得到一大份无关元数据。
ffprobe -v error -select_streams a:0 -show_entries stream=codec_name,sample_fmt,sample_rate,channels,bit_rate:format=duration -of default=noprint_wrappers=1 "<PATH>/tone.wav"预期输出
codec_name=pcm_s16le
sample_fmt=s16
sample_rate=48000
channels=2
bit_rate=1536000
duration=1.000000这里的 codec_name 表示编码格式,sample_fmt 表示解码后样本的数值布局,sample_rate 是每秒采样次数,channels 是声道数,bit_rate 是该音频流的码率,duration 则来自容器层的时长信息。声道布局可先从 FFmpeg 的 stereo、mono 等描述确认;部分文件即使有声道数,也不一定声明完整布局。
遇到真实文件时怎么判断
真实文件不一定像测试 WAV 这样字段齐全。AAC 等有损编码常见 sample_fmt 为 fltp,VBR 文件的码率可能只是平均值;某些文件可能缺少流级码率,但仍能正常解码。因此不要把“字段缺失”直接等同于“文件损坏”。
排查时先看 codec_name、sample_rate、channels 是否符合处理链预期,再检查 sample_fmt 是否被下游 API 支持;若出现播放速度异常,重点核对采样率;若只有一侧有声或声道错乱,检查声道数与布局;若文件大小、时长与码率明显不协调,再继续检查容器、VBR 或截断问题。这样就能把“听起来不对”转成可以比较和自动验证的参数差异。