使用libavcodec编码H264时如何限制CPU占用及编码线程数？

核心原因 #

当前H264软编码默认依赖libx264实现，该编码器的私有配置优先级高于AVCodecContext结构体的通用线程参数，因此直接设置codec_ctx->thread_count会被libx264的默认配置覆盖。

具体操作步骤 #

• 步骤1：在编码器私有选项中显式指定线程数
  在现有codec_options配置中添加threads参数，该配置优先级最高，会被libx264优先识别：

AVDictionary *codec_options = nullptr;
av_dict_set(&codec_options, "profile", "high", 0);
av_dict_set(&codec_options, "preset", "ultrafast", 0);
av_dict_set(&codec_options, "tune", "zerolatency", 0);
// 新增：指定编码线程数
av_dict_set(&codec_options, "threads", "1", 0);

• 步骤2：匹配AVCodecContext的线程类型配置
  在set_codec_params函数中补充thread_type设置，避免FFmpeg自动启用多帧并行编码：

// 原有配置保留
codec_ctx->thread_count = 1;
// 新增：关闭自动多线程，不需要多线程编码时可设为0
codec_ctx->thread_type = 0;

• 步骤3：排查OpenMP环境变量冲突
  如果libx264编译时启用了OpenMP，系统环境变量OMP_NUM_THREADS会覆盖代码配置，可在编码器初始化前强制指定：

// 放在编码器初始化逻辑之前执行
setenv("OMP_NUM_THREADS", "1", 1);

• 步骤4：确认编码器类型
  如果使用NVENC、QSV等硬件H264编码器，线程数由硬件驱动管控，软件层面的通用线程配置不生效，需要通过对应硬件的私有参数调整。

常见冲突配置 #

1. libx264私有threads参数未显式设置：默认值为0（自动匹配CPU核心数），会直接覆盖AVCodecContext::thread_count的配置。
2. thread_type设置为FF_THREAD_AUTO：FFmpeg会自动根据编码场景开启多线程，忽略用户指定的thread_count。
3. OpenMP环境变量OMP_NUM_THREADS设置过高：优先级高于代码中的编码器参数配置。
4. 多实例编码并行运行：即使单实例限制了线程数，总CPU占用也会打满，需要对应调整每个实例的线程配额。

内容的提问来源于stack exchange，提问作者oarfish