音频开发 / 系统课时

用命令行检查音频流参数

用命令行检查音频流参数

面对来源未知的音频文件,先不要急着写代码解析。FFmpeg 适合快速查看媒体流并做转换,ffprobe 更适合输出结构化参数。本篇用一个可重复生成的测试音频,检查采样率、声道、采样格式、编码格式、码率和时长,并说明这些字段如何用于后续排障。

学习目标

  • 用 FFmpeg 快速确认音频流是否能被识别
  • 用 ffprobe 提取可脚本处理的音频参数
  • 判断采样率、声道、采样格式、编码、码率和时长是否彼此一致

先确认工具可用

下面命令适用于 macOS、Linux 或 WSL。版本号会因安装环境不同而变化。

bash
ffmpeg -version | head -n 1
ffprobe -version | head -n 1

预期输出

text
ffmpeg version <VERSION> ...
ffprobe version <VERSION> ...

若命令不存在,先修复 FFmpeg 安装或 PATH,不要继续分析文件参数;否则后面的失败会把“工具不可用”和“媒体有问题”混在一起。

生成一个已知参数的测试文件

先生成 1 秒、48 kHz、双声道、16 位 PCM WAV。把 <PATH> 替换成实际可写目录;实际路径因环境不同而不同。

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

预期结果

text
命令正常结束且没有错误输出,<PATH>/tone.wav 被创建。

这个文件的参数是我们主动指定的,因此适合用来验证后续检查命令是否读对:采样率应为 48000 Hz,声道数为 2,编码为 pcm_s16le,样本格式应为 16 位有符号整数。

用 FFmpeg 快速扫一眼音频流

FFmpeg 的输入探测信息适合人工快速确认“能不能识别”和“主要参数是否合理”。下面只保留时长与第一条输入音频流,避免输出流和进度日志干扰。

bash
ffmpeg -hide_banner -i "<PATH>/tone.wav" -f null - 2>&1 | grep -E 'Duration:|Stream #0:0:' | head -n 2

预期输出

text
  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 则限制字段,避免得到一大份无关元数据。

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

预期输出

text
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 或截断问题。这样就能把“听起来不对”转成可以比较和自动验证的参数差异。

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

目录与阅读设置

阅读设置

17

记录一个想法

用命令行检查音频流参数

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

登录哪都通