ffmpeg_encode_video_frame要求AVFrame为YUV420P，因libx264仅支持该格式；RGB输入须经sws_scale转换，且宽高需为偶数；编码器需禁用GLOBAL_HEADER以输出Annex B裸流；avcodec_receive_packet需循环调用并flush。
ffmpeg_encode_video_frame 函数里为什么传入的 AVFrame 必须是 YUV420P？
因为 libx264 编码器只接受 AV_PIX_FMT_YUV420P（或少数几个 YUV 变体），直接送 AV_PIX_FMT_RGB24 会触发 avcodec_send_frame() 返回 -22（EINVAL）。你不能跳过颜色空间转换——哪怕只是单帧，也得用 sws_scale() 把 RGB 转成 YUV420P。
常见错误现象：avcodec_receive_packet() 一直返回 0，但没输出任何数据包，其实是编码器根本没收到合法帧；或者直接崩溃在 sws_getContext() 初始化失败，因为源/目标格式、宽高没对齐（YUV420P 要求宽高均为偶数）。
- 确保输入 RGB 图像宽高都是偶数，否则
sws_scale()可能静默截断或出错 - 调用
sws_getContext()时，源格式设为AV_PIX_FMT_RGB24，目标格式必须是AV_PIX_FMT_YUV420P - 重采样上下文只需创建一次，反复复用；不要每帧都重建
如何正确初始化 H.264 编码器并禁用容器封装？
裸流（annexb 格式）意味着不写 MP4/AVI 容器头，只输出原始 NAL 单元。这要求设置编码器参数：关闭 AV_CODEC_FLAG_GLOBAL_HEADER，并手动调用 av_bitstream_filter_init("h264_mp4toannexb")（仅当需要把 MP4 风格的 NAL 转成 Annex B 时才用；若直接用 x264 编码且未启用 global header，通常已输出 Annex B）。
关键配置项：
立即学习“C++免费学习笔记（深入）”；
- 设置
codec_ctx->pix_fmt = AV_PIX_FMT_YUV420P - 设置
codec_ctx->width/codec_ctx->height（必须与 sws 上下文一致） - 设置
codec_ctx->time_base = {1, fps}，并同步设codec_ctx->framerate = {fps, 1} - 显式关闭全局头：
codec_ctx->flags &= ~AV_CODEC_FLAG_GLOBAL_HEADER
漏掉 time_base 或设错会导致 PTS 计算混乱，后续帧无法解码；设了 GLOBAL_HEADER 则首帧会带 SPS/PPS 在 packet data 前，但裸流解析器可能不识别这种非标准前缀。
编码循环中怎么处理 avcodec_receive_packet() 的返回值？
它不是“一帧一包”严格对应。x264 内部有帧队列和延迟机制，尤其首帧调用时大概率返回 AVERROR(EAGAIN)（需更多输入），而 flush 阶段（传 nullptr）才会吐出剩余编码帧，包括可能的延迟 B 帧或尾部 filler。
典型流程：
- 循环送入 RGB 帧 → 转 YUV →
avcodec_send_frame() - 每次送完后，用 while 循环反复调用
avcodec_receive_packet()，直到返回EAGAIN或EOF - 所有成功接收的
AVPacket直接写入文件（裸流无头部，append 即可） - 全部图像送完后，再传一次
nullptr触发 flush，收走剩余 packet
容易忽略的是 flush 步骤：不 flush 就关文件，最后几帧就丢了；而 flush 后仍要检查返回值——它可能返回 0（有包）、AVERROR_EOF（结束）或 AVERROR(EAGAIN)（无更多输出）。
RGB 数据怎么填进 AVFrame？别用 av_image_fill_arrays() 硬拷贝
如果你的 RGB 图像是连续内存（如 uint8_t* rgb_data，宽×高×3 字节），最高效方式是直接赋值 frame->data[0] = rgb_data，并设置 frame->linesize[0] = width * 3。不要用 av_image_fill_arrays() 默认按 plane 对齐填充——它会尝试分配新 buffer 并 memcpy，纯属浪费。
注意点：
-
frame->format必须设为AV_PIX_FMT_RGB24（用于 sws 转换），哪怕你最终编码的是 YUV -
frame->width/frame->height必须与实际图像一致，且为偶数 - 如果 RGB 数据是 BGR 排列（OpenCV 默认），记得用
AV_PIX_FMT_BGR24替换AV_PIX_FMT_RGB24，否则颜色错乱
真正复杂的地方不在 API 调用顺序，而在于每个结构体字段的语义是否被准确理解——比如 AVRational time_base 是时间单位，不是帧率倒数；sws_context 的 src/dst 参数一旦建好就不能改；AVPacket 的 data 指针在 avcodec_receive_packet() 后才有效，且生命周期只到下次调用该函数前。
