编码与格式 / 系统课时

打开媒体输入

打开媒体输入

本课完成 FFmpeg 解码程序的第一步:打开本地媒体文件、探测全部流,并自动选出最佳视频流和音频流。最终程序会打印容器信息及目标流索引,为后续创建解码器上下文做好准备。

学习目标

  • 使用 avformat_open_input 打开媒体输入
  • 使用 avformat_find_stream_info 读取并补全流信息
  • 通过 av_find_best_stream 定位目标视频流和音频流

打开输入的正确顺序

媒体文件不能只“打开成功”就立即解码。FFmpeg 需要先创建并填充 AVFormatContext,再读取一部分数据以识别流类型、编码格式、时长和时间基。

FFmpeg 打开媒体并定位流的流程

推荐顺序如下:先调用 avformat_open_input,再调用 avformat_find_stream_info,最后定位目标流。任一步失败都应输出 FFmpeg 错误文本并关闭已创建的资源。

完整示例

下面程序接收一个媒体文件路径,打印 FFmpeg 识别到的容器信息,并分别寻找最佳视频流和音频流。某类流不存在时,程序会输出 not found,但不会把另一类流的成功结果判为失败。

c
#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> 替换为实际媒体文件路径。

bash
cc open_media.c -o open_media $(pkg-config --cflags --libs libavformat libavcodec libavutil)
./open_media <PATH>

预期输出如下。容器名称、流数量、索引、编码名称和时间基由输入文件决定,因此实际值可能不同。

text
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,但生产环境必须额外配置连接超时、读取超时和中断回调,避免调用长期阻塞。

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

目录与阅读设置

阅读设置

17

记录一个想法

打开媒体输入

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

登录哪都通