目录一、音频类二、视频 / 像素格式类三、Codec / Media 类型avcodec四、错误码 / 状态调试必用五、AVFormat / IO / Seek 相关六、Log / Level / DTS 之类七、完整对照速查表八、Qt / C 友好封装九、一个“打印流信息”的一行版十、一句话总结觉得有用就请您帮忙点赞转发收藏吧您的鼓励是我创作的动力多谢看官。由于能力水平有限文中的错误或不严谨的地方在所难免还请批评指正。在FFmpeg库中处理枚举类型并获取它们的名称是一个常见的需求尤其是在调试或显示信息时。FFmpeg提供了多种函数来实现这一功能这些函数通常位于libavutil和libavcodec库中。以下是一些常用的函数它们可以帮助你根据枚举获取名称。结论先说FFmpeg 几乎所有核心 enum 都有官方get_name函数但名字不统一有av_*/avcodec_*/avutil_*下面按模块整理表格为主实战优先。一、音频类枚举获取名称函数返回内容示例AVSampleFormatav_get_sample_fmt_name()s16,fltpav_get_sample_fmt_name(AV_SAMPLE_FMT_S16)AVChannelLayoutav_channel_layout_describe()stereo,5.1av_channel_layout_describe(ch)AVChannelav_get_channel_name()FL,FRav_get_channel_name(AV_CHAN_FRONT_LEFT)AVChannelOrderav_channel_order_name()native,waveFFmpeg ≥ 5.1AVSampleRate无 enum自己QString::number()––音频三件套Qt 调试神器qDebug(fmt%s ch%s rate%d, av_get_sample_fmt_name(fmt), av_channel_layout_describe(layout), rate);二、视频 / 像素格式类枚举获取名称函数返回内容示例AVPixelFormatav_get_pix_fmt_name()yuv420p,rgb24AVColorSpaceav_color_space_name()bt709,bt2020FFmpeg ≥ 6AVColorPrimariesav_color_primaries_name()bt709AVColorTransferCharacteristicav_color_transfer_name()srgb,pqAVColorRangeav_color_range_name()mpeg,jpegAVFieldOrderav_frame_get_side_data() enumtop_bottom少直接用三、Codec / Media 类型avcodec枚举函数返回AVCodecIDavcodec_get_name()aac,h264AVMediaTypeav_get_media_type_string()audio,videoAVProfileavcodec_profile_name()High,Main打印流信息替代 av_dump_format 的轻量版qDebug([%s] codec%s profile%s, av_get_media_type_string(st-codecpar-codec_type), avcodec_get_name(st-codecpar-codec_id), avcodec_profile_name(st-codecpar-codec_id, st-codecpar-profile));四、错误码 / 状态调试必用类型函数说明int retav_strerror()转字符串不是 enumAVERROR_EOF用av_strerror()End of fileAVERROR(EAGAIN)Resource temporarily unavailable标准写法char err[128]; av_strerror(ret, err, sizeof err); qDebug(ff err: %s, err);五、AVFormat / IO / Seek 相关枚举函数返回AVFMT_*flags无统一函数自己fmt_ctx-iformat-nameAVIOContextprotocolfmt_ctx-iformat-namertsp,mp4seek flags无AVSEEK_FLAG_BACKWARD手写协议名fmt_ctx-iformat-name // mov,mp4,m4a,3gp六、Log / Level / DTS 之类枚举函数AVLogLevel无自己 switchAVDiscard无AVOptionTypeav_opt_type_name()FFmpeg ≥ 6七、完整对照速查表你看到的 enum正确 APIAVCodecID idavcodec_get_name(id)AVMediaType tav_get_media_type_string(t)AVSampleFormat fav_get_sample_fmt_name(f)AVPixelFormat pav_get_pix_fmt_name(p)AVChannelLayout cav_channel_layout_describe()int errav_strerror()AVProfile pavcodec_profile_name()八、Qt / C 友好封装inline QString ff_codec(const AVCodecParameters *p) { return avcodec_get_name(p-codec_id); } inline QString ff_fmt(AVSampleFormat f) { return av_get_sample_fmt_name(f); } inline QString ff_pix(AVPixelFormat f) { return av_get_pix_fmt_name(f) ? : unknown; } inline QString ff_err(int r) { char b[256]; av_strerror(r, b, sizeof b); return b; }九、一个“打印流信息”的一行版void dump(AVStream *s) { qDebug(type%s codec%s fmt%s ch%d rate%d, av_get_media_type_string(s-codecpar-codec_type), avcodec_get_name(s-codecpar-codec_id), av_get_sample_fmt_name((AVSampleFormat)s-codecpar-format), s-codecpar-ch_layout.nb_channels, s-codecpar-sample_rate); }十、一句话总结FFmpeg 的命名规则av_xxx_name()→ avutil / formatavcodec_xxx_name()→ codecav_xxx_describe()→ channel / layout错误一律av_strerror()