FFmpeg自定义datamosh比特流过滤器target参数无法识别问题

问题背景 #

编写了针对视频流的datamosh比特流过滤器，功能为：

• target为正数时，丢弃第N个关键帧
• target为非正数时，保留前|N|个关键帧并丢弃其余帧

执行命令时出现参数识别错误：

ffmpeg -i input.webm -bsf:v datamosh=target=20 -c copy output.webm

错误信息：

Option 'target' not found
[vost#0:0/copy @ 0x54edc40] Error parsing bitstream filter sequence 'datamosh=target=20': Option not found

但执行ffmpeg -h bsf=datamosh能正常显示target参数的说明。

可能的解决方法 #

1. 移除不必要的参数类型标记 #

代码中FLAGS定义包含了AV_OPT_FLAG_AUDIO_PARAM，但该BSF仅针对视频流，多余的标记可能干扰参数解析逻辑：

// 原定义
#define FLAGS (AV_OPT_FLAG_VIDEO_PARAM|AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_BSF_PARAM)

// 修改为仅保留视频和BSF相关标记
#define FLAGS (AV_OPT_FLAG_VIDEO_PARAM | AV_OPT_FLAG_BSF_PARAM)

2. 确保FFmpeg版本与代码头文件兼容 #

若编译时使用的FFmpeg库版本与代码依赖的头文件版本不一致，会导致AVOption或BSF结构解析异常：

• 确认编译链接的FFmpeg库版本与代码包含的头文件版本完全匹配
• 优先使用FFmpeg稳定版（如6.x/7.x）重新编译BSF

3. 调整参数传递格式尝试验证 #

可以尝试两种参数传递方式，排查解析逻辑问题：

• 省略参数名直接传值（利用AVOption的默认位置参数特性）：

  ffmpeg -i input.webm -bsf:v datamosh=20 -c copy output.webm
  

• 使用短格式参数传递（适配部分旧版本FFmpeg的解析逻辑）：

  ffmpeg -i input.webm -bsf:v datamosh="-target 20" -c copy output.webm
  

4. 检查BSF注册完整性 #

• 静态编译场景：需在libavcodec/allbsf.c中添加注册代码，再重新编译FFmpeg：

  REGISTER_BSF(datamosh, datamosh);
  

• 动态模块场景：确保模块初始化函数正确注册该BSF：

  static const AVBitStreamFilter * const bsf_list[] = {
      &ff_datamosh_bsf,
      NULL
  };
  
  module_init() {
      av_register_all_bitstream_filters(bsf_list);
  }
  

额外功能修正提示 #

当前代码逻辑存在一处偏差：当target为非正数时，s->i仅在target为正数的分支中递增（仅关键帧触发），导致无法实现"保留前N个关键帧"的功能。需修改计数逻辑：

static int datamosh(AVBSFContext *ctx, AVPacket *pkt)
{
    DatamoshContext *s = ctx->priv_data;
    int ret;

    ret = ff_bsf_get_packet_ref(ctx, pkt);
    if (ret < 0)
        return ret;

    // 统一对关键帧计数，无论target值
    if (pkt->flags & AV_PKT_FLAG_KEY)
        ++s->i;

    if (s->target < 1) {
        if (s->i <= -s->target)
            return 0;
        else {
            av_packet_unref(pkt);
            return AVERROR(EAGAIN);
        }
    }

    if (s->i == s->target) {
        av_packet_unref(pkt);
        return AVERROR(EAGAIN);
    }

    return 0;
}

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