首页 > 代码库 > 如何利用 AVDictionary 配置参数（转）

如何利用 AVDictionary 配置参数（转）

2024-09-14 22:36:45   214人阅读

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

1.  AVDictionary 的用法简介

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

[cpp] view plain copy
 
 print?
  1. struct AVDictionary {    
  2.     int count;    
  3.     AVDictionaryEntry *elems;    
  4. };  

其中，AVDictionaryEntry 的定义如下：

[cpp] view plain copy
 
 print?
  1. typedef struct AVDictionaryEntry {    
  2.     char *key;    
  3.     char *value;    
  4. } AVDictionaryEntry;  

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

（1）创建一个字典

 

[cpp] view plain copy
 
 print?
  1. AVDictionary *d = NULL;  

（2） 销毁一个字典

 

[cpp] view plain copy
 
 print?
  1. av_dict_free(&d);  

（3）添加一对 key-value

 

[cpp] view plain copy
 
 print?
  1. av_dict_set(&d, "name", "jhuster", 0);  
  2. av_dict_set_int(&d, "age", "29", 0);  

（4） 获取 key 的值

 

[cpp] view plain copy
 
 print?
  1. AVDictionaryEntry *t = NULL;  
  2.   
  3. t = av_dict_get(d, "name", NULL, AV_DICT_IGNORE_SUFFIX);  
  4. av_log(NULL, AV_LOG_DEBUG, "name: %s", t->value);  
  5.   
  6. t = av_dict_get(d, "age", NULL, AV_DICT_IGNORE_SUFFIX);  
  7. av_log(NULL, AV_LOG_DEBUG, "age: %d", (int) (*t->value));  

（5） 遍历字典

 

[cpp] view plain copy
 
 print?
  1. AVDictionaryEntry *t = NULL;  
  2. while ((t = av_dict_get(d, "", t, AV_DICT_IGNORE_SUFFIX))) {  
  3.     av_log(NULL, AV_LOG_DEBUG, "%s: %s", t->key, t->value);  
  4. }  

2.  ffmpeg 参数的传递

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

[cpp] view plain copy
 
 print?
  1. int avformat_open_input(AVFormatContext **ps, const char *url, AVInputFormat *fmt, AVDictionary **options);  

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

[cpp] view plain copy
 
 print?
  1. AVDictionary *options = NULL;  
  2. av_dict_set(&options, “probesize”, “4096", 0);  
  3. av_dict_set(&options, “max_delay”, “5000000”, 0);  
  4.   
  5. AVFormatContext *ic = avformat_alloc_context();  
  6. if (avformat_open_input(&ic, url, NULL, &options) < 0) {  
  7.     LOGE("could not open source %s", url);  
  8.     return -1;  
  9. }  

那么，我们怎么知道 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 选项，这篇文章就不展开详述了。

http://blog.csdn.net/encoder1234/article/details/54582676

如何利用 AVDictionary 配置参数（转）


联系
我们