编码与格式 / 系统课时
打开媒体输入
打开媒体输入
本课完成 FFmpeg 解码程序的第一步:打开本地媒体文件、探测全部流,并自动选出最佳视频流和音频流。最终程序会打印容器信息及目标流索引,为后续创建解码器上下文做好准备。
学习目标
- 使用
avformat_open_input打开媒体输入 - 使用
avformat_find_stream_info读取并补全流信息 - 通过
av_find_best_stream定位目标视频流和音频流
打开输入的正确顺序
媒体文件不能只“打开成功”就立即解码。FFmpeg 需要先创建并填充 AVFormatContext,再读取一部分数据以识别流类型、编码格式、时长和时间基。

推荐顺序如下:先调用 avformat_open_input,再调用 avformat_find_stream_info,最后定位目标流。任一步失败都应输出 FFmpeg 错误文本并关闭已创建的资源。
完整示例
下面程序接收一个媒体文件路径,打印 FFmpeg 识别到的容器信息,并分别寻找最佳视频流和音频流。某类流不存在时,程序会输出 not found,但不会把另一类流的成功结果判为失败。
#include <stdio.h>
#include <libavcodec/avcodec.h>
#include <libavformat/avformat.h>
#include <libavutil/error.h>
static void print_error(const char *operation, int error_code) {
char error_buffer[AV_ERROR_MAX_STRING_SIZE] = {0};
av_strerror(error_code, error_buffer, sizeof(error_buffer));
fprintf(stderr, "%s failed: %s\n", operation, error_buffer);
}
static void print_stream_result(
AVFormatContext *format_ctx,
enum AVMediaType media_type,
const char *label
) {
int stream_index = av_find_best_stream(
format_ctx,
media_type,
-1,
-1,
NULL,
0
);
if (stream_index < 0) {
printf("%s stream: not found\n", label);
return;
}
AVStream *stream = format_ctx->streams[stream_index];
const char *codec_name = avcodec_get_name(stream->codecpar->codec_id);
printf(
"%s stream: index=%d, codec=%s, time_base=%d/%d\n",
label,
stream_index,
codec_name,
stream->time_base.num,
stream->time_base.den
);
}
int main(int argc, char **argv) {
if (argc != 2) {
fprintf(stderr, "Usage: %s <media-file>\n", argv[0]);
return 1;
}
AVFormatContext *format_ctx = NULL;
int ret = avformat_open_input(&format_ctx, argv[1], NULL, NULL);
if (ret < 0) {
print_error("avformat_open_input", ret);
return 1;
}
ret = avformat_find_stream_info(format_ctx, NULL);
if (ret < 0) {
print_error("avformat_find_stream_info", ret);
avformat_close_input(&format_ctx);
return 1;
}
printf("format: %s\n", format_ctx->iformat->name);
printf("stream count: %u\n", format_ctx->nb_streams);
print_stream_result(format_ctx, AVMEDIA_TYPE_VIDEO, "video");
print_stream_result(format_ctx, AVMEDIA_TYPE_AUDIO, "audio");
avformat_close_input(&format_ctx);
return 0;
}该示例依赖 FFmpeg 的 libavformat、libavcodec 与 libavutil 开发包。Linux 或 macOS 环境可使用 pkg-config 生成编译参数;将 <PATH> 替换为实际媒体文件路径。
cc open_media.c -o open_media $(pkg-config --cflags --libs libavformat libavcodec libavutil)
./open_media <PATH>预期输出如下。容器名称、流数量、索引、编码名称和时间基由输入文件决定,因此实际值可能不同。
format: mov,mp4,m4a,3gp,3g2,mj2
stream count: 2
video stream: index=0, codec=h264, time_base=1/12800
audio stream: index=1, codec=aac, time_base=1/48000关键 API 与返回值
avformat_open_input 的第一个参数是 AVFormatContext **。成功后,FFmpeg 会创建或填充上下文;失败时返回负数错误码。第三个参数传 NULL 表示自动识别输入格式,第四个参数可传入协议或解复用器选项。
avformat_find_stream_info 会读取部分数据以补全流信息。它可能带来少量启动开销,但对可靠识别编码参数非常重要。对于网络流,还需要结合超时和探测大小控制等待时间。
av_find_best_stream 不只是寻找第一个同类型流,还会按 FFmpeg 的规则选择更合适的流。返回值是流索引;负数表示未找到或发生错误。音频文件没有视频流、静音视频没有音频流,都属于正常边界。
验证与失败处理
运行后先确认 stream count 大于零,再检查目标流索引是否符合预期。需要查看全部流的详细信息时,可在调试阶段调用 av_dump_format(format_ctx, 0, argv[1], 0),它会把容器和流信息输出到标准错误。
常见失败包括路径错误、文件权限不足、输入损坏,以及 FFmpeg 构建未包含对应解复用器。不要只打印返回码;使用 av_strerror 转换为可读错误文本,定位效率更高。
Tips:网络地址也可以交给
avformat_open_input,但生产环境必须额外配置连接超时、读取超时和中断回调,避免调用长期阻塞。