本文是我的 FFMPEG Tips 系列的第五篇文章，准备介绍下 ffmpeg 提供的一个非常好用的健值对工具：AVDictionary，特别是对于没有 map 容器的 c 代码，可以充分利用它来配置和定义播放器的参数，ffmpeg 本身也有很多 API 通过它来传递参数。

成都创新互联公司是一家集网站建设,邯郸企业网站建设,邯郸品牌网站建设,网站定制,邯郸网站建设报价,网络营销,网络优化,邯郸网站推广为一体的创新建站企业，帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿，时刻以成就客户成长自我，坚持不断学习、思考、沉淀、净化自己，让我们为更多的企业打造出实用型网站。成都创新互联公司专注于合水网站建设服务及定制，我们拥有丰富的企业做网站经验。 热诚为您提供合水营销型网站建设，合水网站制作、合水网页设计、合水网站官网定制、成都小程序开发服务，打造合水网络公司原创品牌,更为您提供合水网站排名全网营销落地服务。

1.  AVDictionary 的用法简介

AVDictionary 所在的头文件在 libavutil/dict.h，其定义如下：

struct AVDictionary {  
    int count;  
    AVDictionaryEntry *elems;  
};

其中，AVDictionaryEntry 的定义如下：

typedef struct AVDictionaryEntry {  
    char *key;  
    char *value;  
} AVDictionaryEntry;

下面就用示例的方式简单介绍下用法

（1）创建一个字典

AVDictionary *d = NULL;

（2） 销毁一个字典

av_dict_free(&d);

（3）添加一对 key-value

av_dict_set(&d, "name", "jhuster", 0);
av_dict_set_int(&d, "age", "29", 0);

（4） 获取 key 的值

AVDictionaryEntry *t = NULL;

t = av_dict_get(d, "name", NULL, AV_DICT_IGNORE_SUFFIX);
av_log(NULL, AV_LOG_DEBUG, "name: %s", t->value);

t = av_dict_get(d, "age", NULL, AV_DICT_IGNORE_SUFFIX);
av_log(NULL, AV_LOG_DEBUG, "age: %d", (int) (*t->value));

（5） 遍历字典

AVDictionaryEntry *t = NULL;
while ((t = av_dict_get(d, "", t, AV_DICT_IGNORE_SUFFIX))) {
    av_log(NULL, AV_LOG_DEBUG, "%s: %s", t->key, t->value);
}

2.  ffmpeg 参数的传递

ffmpeg 中很多 API 都是靠 AVDictionary 来传递参数的，比如常用的：

int avformat_open_input(AVFormatContext **ps, const char *url, AVInputFormat *fmt, AVDictionary **options);

最后一个参数就是 AVDictionary，我们可以在打开码流前指定各种参数，比如：探测时间、超时时间、大延时、支持的协议的白名单等等，例如：

AVDictionary *options = NULL;
av_dict_set(&options, “probesize”, “4096", 0);
av_dict_set(&options, “max_delay”, “5000000”, 0);

AVFormatContext *ic = avformat_alloc_context();
if (avformat_open_input(&ic, url, NULL, &options) < 0) {
    LOGE("could not open source %s", url);
    return -1;
}

那么，我们怎么知道 ffmpeg 的这个 API 支持哪些可配置的参数呢 ？

我们可以查看 ffmpeg 源码，比如 avformat_open_input 是结构体 AVFormatContext 提供的 API，在 libavformat/options_table.h 中定义了 AVFormatContext 所有支持的 options 选项，如下所示：

https://www.ffmpeg.org/doxygen/trunk/libavformat_2options__table_8h-source.html

同理，AVCodec 相关 API 支持的 options 选项则可以在 libavcodec/options_table.h 文件中找到，如下所示：

https://www.ffmpeg.org/doxygen/3.1/libavcodec_2options__table_8h_source.html

3.  小结

当然，我们也可以仿照 ffmpeg，给自己的核心结构体对象定义这样的 options 选项，这篇文章就不展开详述了。

关于如何利用 AVDictionary 配置参数就介绍到这儿了，文章中有不清楚的地方欢迎留言或者来信 lujun.hust@gmail.com 交流，关注我的新浪微博 @卢_俊 或者 微信公众号 @Jhuster 获取最新的文章和资讯。

另外有需要云服务器可以了解下创新互联scvps.cn，海内外云服务器15元起步，三天无理由+7*72小时售后在线，公司持有idc许可证，提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案，具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势，专为企业上云打造定制，能够满足用户丰富、多元化的应用场景需求。

当前文章：FFMPEGTips(5)如何利用AVDictionary配置参数-创新互联
文章路径：http://kswjz.com/article/cehcgs.html