Linux FFmpeg深度解析之avcodec_alloc_context3调用流程与实战(十四)

简介: CSDN博客专家、《Android系统多媒体进阶实战》作者

博主新书推荐:《Android系统多媒体进阶实战》🚀

Android Audio工程师专栏地址:Audio工程师进阶系列【原创干货持续更新中...... 】🚀

Android多媒体专栏地址:多媒体系统工程师系列【原创干货持续更新中...... 】🚀

专题一 二:AAOS车载系统+AOSP14系统攻城狮入门视频实战课 🚀

专题三:Android14 Binder之HIDL与AIDL通信实战课 🚀

专题四:Android15快速自定义与集成音效实战课 🚀

专题五:Android15音频策略实战课 🚀

专题六:Android15音频性能实战课(无声/杂音/断音/爆音实战案例) 🚀

人生格言: 人生从来没有捷径,只有行动才是治疗恐惧和懒惰的唯一良药.
更多原创,欢迎关注:Android系统攻城狮

点击获取二维码

🍉🍉🍉文章目录🍉🍉🍉

🌻1.前言

本篇目的:理解avcodec_alloc_context3()如何创建并初始化AVCodecContext,明确传入AVCodec与传入NULL时的差别,并通过最小程序检查新Context的初始状态。

AVCodecContext是编解码器的配置和运行状态对象。调用avcodec_alloc_context3()会分配这个对象并设置通用默认值;如果传入具体AVCodec,还会初始化对应的编解码器私有数据和默认选项。该函数不会打开编解码器,也不会开始收发Packet或Frame。
#mermaid-svg-d1Swq7KYT6ROO33w{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-d1Swq7KYT6ROO33w .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-d1Swq7KYT6ROO33w .error-icon{fill:#552222;}#mermaid-svg-d1Swq7KYT6ROO33w .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-d1Swq7KYT6ROO33w .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-d1Swq7KYT6ROO33w .marker{fill:#333333;stroke:#333333;}#mermaid-svg-d1Swq7KYT6ROO33w .marker.cross{stroke:#333333;}#mermaid-svg-d1Swq7KYT6ROO33w svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-d1Swq7KYT6ROO33w p{margin:0;}#mermaid-svg-d1Swq7KYT6ROO33w .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-d1Swq7KYT6ROO33w .cluster-label text{fill:#333;}#mermaid-svg-d1Swq7KYT6ROO33w .cluster-label span{color:#333;}#mermaid-svg-d1Swq7KYT6ROO33w .cluster-label span p{background-color:transparent;}#mermaid-svg-d1Swq7KYT6ROO33w .label text,#mermaid-svg-d1Swq7KYT6ROO33w span{fill:#333;color:#333;}#mermaid-svg-d1Swq7KYT6ROO33w .node rect,#mermaid-svg-d1Swq7KYT6ROO33w .node circle,#mermaid-svg-d1Swq7KYT6ROO33w .node ellipse,#mermaid-svg-d1Swq7KYT6ROO33w .node polygon,#mermaid-svg-d1Swq7KYT6ROO33w .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-d1Swq7KYT6ROO33w .rough-node .label text,#mermaid-svg-d1Swq7KYT6ROO33w .node .label text,#mermaid-svg-d1Swq7KYT6ROO33w .image-shape .label,#mermaid-svg-d1Swq7KYT6ROO33w .icon-shape .label{text-anchor:middle;}#mermaid-svg-d1Swq7KYT6ROO33w .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-d1Swq7KYT6ROO33w .rough-node .label,#mermaid-svg-d1Swq7KYT6ROO33w .node .label,#mermaid-svg-d1Swq7KYT6ROO33w .image-shape .label,#mermaid-svg-d1Swq7KYT6ROO33w .icon-shape .label{text-align:center;}#mermaid-svg-d1Swq7KYT6ROO33w .node.clickable{cursor:pointer;}#mermaid-svg-d1Swq7KYT6ROO33w .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-d1Swq7KYT6ROO33w .arrowheadPath{fill:#333333;}#mermaid-svg-d1Swq7KYT6ROO33w .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-d1Swq7KYT6ROO33w .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-d1Swq7KYT6ROO33w .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-d1Swq7KYT6ROO33w .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-d1Swq7KYT6ROO33w .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-d1Swq7KYT6ROO33w .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-d1Swq7KYT6ROO33w .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-d1Swq7KYT6ROO33w .cluster text{fill:#333;}#mermaid-svg-d1Swq7KYT6ROO33w .cluster span{color:#333;}#mermaid-svg-d1Swq7KYT6ROO33w div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-d1Swq7KYT6ROO33w .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-d1Swq7KYT6ROO33w rect.text{fill:none;stroke-width:0;}#mermaid-svg-d1Swq7KYT6ROO33w .icon-shape,#mermaid-svg-d1Swq7KYT6ROO33w .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-d1Swq7KYT6ROO33w .icon-shape p,#mermaid-svg-d1Swq7KYT6ROO33w .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-d1Swq7KYT6ROO33w .icon-shape .label rect,#mermaid-svg-d1Swq7KYT6ROO33w .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-d1Swq7KYT6ROO33w .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-d1Swq7KYT6ROO33w .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-d1Swq7KYT6ROO33w :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} AVCodec或NULL
avcodec_alloc_context3
分配AVCodecContext
初始化通用默认值
按需初始化编解码器私有数据
返回可配置的Context

🌻2.应用场景和用法

2.1创建编解码器配置对象

编解码流程需要一个AVCodecContext保存参数,例如编码宽高、像素格式、码率、音频采样率和声道布局。avcodec_alloc_context3()负责创建这个对象,让调用者能够继续配置并交给avcodec_open2()初始化。

传入已找到的编解码器时,Context会按该编解码器设置类型、ID和私有默认值。传入NULL时,只初始化通用默认值;调用者之后仍可以通过avcodec_open2()指定Codec,但编码器可能缺少与特定实现相关的默认设置。

用法 传入参数 得到的对象状态
创建解码Context avcodec_find_decoder()返回的AVCodec 设置解码器类型与ID,并准备相关私有默认值
创建编码Context avcodec_find_encoder()返回的AVCodec 设置编码器类型与ID,并准备相关私有默认值
延后选择Codec NULL 只创建通用Context,后续再指定Codec
分配失败 合法的Codec或NULL 返回NULL,没有可用Context
2.2函数原型与返回语义

函数原型如下:

c 复制代码
AVCodecContext *
avcodec_alloc_context3 (const AVCodec *codec);

参数codec可以是解码器、编码器对象,也可以是NULL。成功时返回新分配的AVCodecContext,失败时返回NULL。返回对象的释放责任属于调用者,应使用avcodec_free_context(),不能只对Context调用av_free()。

同一个Context一旦按某个非空Codec创建,后续调用avcodec_open2()时必须使用相同Codec或传入NULL让FFmpeg沿用已关联的Codec。这个函数只创建并初始化配置对象,不会选择文件流、不解析压缩数据,也不创建AVPacket或AVFrame。

🌻3.调用流程剖析

3.1分配内存并设置通用默认值

avcodec_alloc_context3()先分配AVCodecContext结构体内存。分配成功后调用内部初始化函数,把对象清零,设置AVClass,再根据传入Codec设置codec_type和codec_id。

初始化还会设置一组通用选项和默认回调,例如默认缓冲区申请函数、像素格式和采样格式初值、时间基初值以及声道布局状态。若传入Codec,函数会根据Codec类别配置音频、视频或字幕相关选项。
#mermaid-svg-WItaL8GRwZtBLQbg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-WItaL8GRwZtBLQbg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-WItaL8GRwZtBLQbg .error-icon{fill:#552222;}#mermaid-svg-WItaL8GRwZtBLQbg .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-WItaL8GRwZtBLQbg .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-WItaL8GRwZtBLQbg .marker{fill:#333333;stroke:#333333;}#mermaid-svg-WItaL8GRwZtBLQbg .marker.cross{stroke:#333333;}#mermaid-svg-WItaL8GRwZtBLQbg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-WItaL8GRwZtBLQbg p{margin:0;}#mermaid-svg-WItaL8GRwZtBLQbg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-WItaL8GRwZtBLQbg .cluster-label text{fill:#333;}#mermaid-svg-WItaL8GRwZtBLQbg .cluster-label span{color:#333;}#mermaid-svg-WItaL8GRwZtBLQbg .cluster-label span p{background-color:transparent;}#mermaid-svg-WItaL8GRwZtBLQbg .label text,#mermaid-svg-WItaL8GRwZtBLQbg span{fill:#333;color:#333;}#mermaid-svg-WItaL8GRwZtBLQbg .node rect,#mermaid-svg-WItaL8GRwZtBLQbg .node circle,#mermaid-svg-WItaL8GRwZtBLQbg .node ellipse,#mermaid-svg-WItaL8GRwZtBLQbg .node polygon,#mermaid-svg-WItaL8GRwZtBLQbg .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-WItaL8GRwZtBLQbg .rough-node .label text,#mermaid-svg-WItaL8GRwZtBLQbg .node .label text,#mermaid-svg-WItaL8GRwZtBLQbg .image-shape .label,#mermaid-svg-WItaL8GRwZtBLQbg .icon-shape .label{text-anchor:middle;}#mermaid-svg-WItaL8GRwZtBLQbg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-WItaL8GRwZtBLQbg .rough-node .label,#mermaid-svg-WItaL8GRwZtBLQbg .node .label,#mermaid-svg-WItaL8GRwZtBLQbg .image-shape .label,#mermaid-svg-WItaL8GRwZtBLQbg .icon-shape .label{text-align:center;}#mermaid-svg-WItaL8GRwZtBLQbg .node.clickable{cursor:pointer;}#mermaid-svg-WItaL8GRwZtBLQbg .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-WItaL8GRwZtBLQbg .arrowheadPath{fill:#333333;}#mermaid-svg-WItaL8GRwZtBLQbg .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-WItaL8GRwZtBLQbg .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-WItaL8GRwZtBLQbg .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-WItaL8GRwZtBLQbg .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-WItaL8GRwZtBLQbg .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-WItaL8GRwZtBLQbg .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-WItaL8GRwZtBLQbg .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-WItaL8GRwZtBLQbg .cluster text{fill:#333;}#mermaid-svg-WItaL8GRwZtBLQbg .cluster span{color:#333;}#mermaid-svg-WItaL8GRwZtBLQbg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-WItaL8GRwZtBLQbg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-WItaL8GRwZtBLQbg rect.text{fill:none;stroke-width:0;}#mermaid-svg-WItaL8GRwZtBLQbg .icon-shape,#mermaid-svg-WItaL8GRwZtBLQbg .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-WItaL8GRwZtBLQbg .icon-shape p,#mermaid-svg-WItaL8GRwZtBLQbg .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-WItaL8GRwZtBLQbg .icon-shape .label rect,#mermaid-svg-WItaL8GRwZtBLQbg .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-WItaL8GRwZtBLQbg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-WItaL8GRwZtBLQbg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-WItaL8GRwZtBLQbg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 传入Codec指针
分配Context内存
清零结构体并设置AVClass
设置Codec类别和ID
初始化通用选项和默认回调
返回Context指针

3.2按Codec初始化私有数据

传入具体Codec后,初始化逻辑会检查该Codec是否有私有数据空间;如果有,就为priv_data分配内存,并应用Codec私有选项的默认值。Codec还可以定义一组默认参数,初始化函数会将其写入Context。

因此,传入Codec与传入NULL的区别不只是Context里是否有一个Codec指针。前者能提前获得针对该实现的默认配置,后者只具备公共的基础状态。编码器尤其可能依赖实现级默认值。

分配或私有数据初始化失败时,函数会释放已分配的Context并返回NULL。返回非空对象表示创建成功,但不代表Codec已经完成初始化。真正的打开动作由avcodec_open2()负责。

🌻4.实战案例

4.1选择解码器并准备Context

示例选择H.264解码器,并把其AVCodec对象传给avcodec_alloc_context3()。此时Context已关联解码器类型和ID,但尚未打开,也没有开始解码。

4.2检查初始状态和释放对象

程序检查Codec查找和Context分配是否成功,再确认Context中的Codec ID与选择的解码器一致。最后使用avcodec_free_context()释放对象,该接口会将指针置为NULL。

4.3完整代码
c 复制代码
#include <libavcodec/avcodec.h>

int
main (void)
{
  const AVCodec *decoder;
  AVCodecContext *context;

  /* 查找H.264解码器实现 */
  decoder = avcodec_find_decoder (AV_CODEC_ID_H264);
  if (decoder == NULL)
    return 1;

  /* 分配并初始化与该解码器关联的Context */
  context = avcodec_alloc_context3 (decoder);
  if (context == NULL)
    return 1;

  /* 检查分配结果,Context此时还没有打开 */
  if (context->codec_id != AV_CODEC_ID_H264 ||
      context->codec_type != AVMEDIA_TYPE_VIDEO) {
    avcodec_free_context (&context);
    return 1;
  }

  /* 使用配套接口释放Context及其关联资源 */
  avcodec_free_context (&context);

  return context == NULL ? 0 : 1;
}

🌻5.总结

avcodec_alloc_context3()负责分配并初始化AVCodecContext,传入具体Codec时还会准备相应的私有默认值,但它不会打开编解码器。

相关推荐
少司府2 分钟前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
分布式存储与RustFS12 分钟前
桶里的文件想当目录使:用 ZeroFS 把 RustFS 挂成一棵 POSIX 树
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
老余说AI38 分钟前
跨境电商、课程出海:六款多语言视频翻译工具选型指南
大数据·运维·人工智能
不积跬步无以至千里mmbb2642 分钟前
Rust三大核心:Trait Crate Mod详解
linux·rust
分布式存储与RustFS1 小时前
向量表别堆本地盘:用 LanceDB 把数据集建在 RustFS 上
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
无忧.芙桃16 小时前
Linux系统编程(四):用户与权限管理
linux·运维·服务器
谙弆悕博士18 小时前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
戊本菌19 小时前
进程(三)进程优先级:谁先上 CPU
linux·c语言·硬件架构
aningx20 小时前
Arch 系用 greetd 实现开机自动进 Plasma Wayland,注销自动回桌面
linux
江无行者20 小时前
Linux 服务器 top 命令详解
linux