音视频

ijkplayer 源码分析（上）

本文基于0.8.8版本的 ijkplayer ，对其源码进行剖析，涉及到不同平台下的封装接口或处理方式时，均以 Android 为例。

ijkplayer 是一款比较出众的开源 Android/IOS 跨平台播放器，基于 ffplay，API 易于集成，可定制编译控制体积。

ijkplayer 集成了三种播放器实现：

  • AndroidMediaPlayer：即安卓系统自带的播放器 MediaPlayer，基于 MediaCodec、AudioTrack 等安卓系统 API.
  • IjkExoMediaPlayer：即谷歌新推出的 ExoPlayer，同样是基于 MediaCodec、AudioTrack 等安卓系统 API，但相比 MediaPlayer 具有支持 DASH、高级 HLS、自定义扩展等优点。
  • IjkMediaPlayer：基于 FFmpeg 的 ffplay，集成了 MediaCodec 硬解码器、Opengl 渲染方式等。

一般而言， ijkplayer 就是指 IjkMediaPlayer，本文分析的对象就是 IjkMediaPlayer.

对 Android 而言，音频输出支持 AudioTrack、OpenSL ES 方式；视频输出支持 NativeWindow、OpenGL ES 方式。

对 ijkplayer 不熟悉的同学建议参看源码阅读本文。

一、初始化

ijkplayer 在 Java 层的操作封装于 IjkMediaPlayer.java ，其中包含一些与底层通信的关键方法，比如播放控制相关的 start、pause、stop 等， 这些 native 方法对应的底层实现位于 ijkpalyer_ini.c 文件中。

在 IjkMediaPlayer.java 中有一些 @CalledByNative 注解的方法，比如底层的播放状态回调，这些方法由底层主动调用，具体位于 IjkMediaPlayer.c 文件中。

ijkplayer 的初始化位于 initPlayer 方法，共做了四件事：

  1. 加载 so 库
  2. 静态初始化底层，底层其实什么都没做
  3. 初始化 Message Handler，处理底层状态信息的上报
  4. 初始化底层，这部分做的工作最多，主要逻辑位于 ijkpalyer_android 的 ijkmp_android_create 方法，如下：
1
2
3
4
5
6
7
8
// 创建底层播放器对象，设置消息处理函数
IjkMediaPlayer *mp = ijkmp_create(msg_loop, saveMode, hard_mux);

// 创建图像渲染对象
mp->ffplayer->vout = SDL_VoutAndroid_CreateForAndroidSurface();

// 初始化视频解码器（软/硬）、音频输出设备（opensles/audioTrack）
mp->ffplayer->pipeline = ffpipeline_create_from_android(mp->ffplayer);

具体是怎么选择软解码器还是硬解码器的呢，跟踪 ffpipeline_create_from_android 方法可以看到：

1
2
3
4
5
6
7
if (ffp->mediacodec_all_videos || ffp->mediacodec_avc || ffp->mediacodec_hevc || ffp->mediacodec_mpeg2)
    // 创建硬解码器
    node = ffpipenode_create_video_decoder_from_android_mediacodec(ffp, pipeline, opaque->weak_vout);
if (!node) {
    // 创建软解码器
    node = ffpipenode_create_video_decoder_from_ffplay(ffp);
}

ffp 的 mediacodec_all_videos 等属性是通过 IjkMediaPlayer 的成员方法 setOption() 设置的，成员方法的调用肯定是在类初始化之后的，而解码器等依赖配置项的设置却在初始化中，难道不是应该先设置，后初始化吗？代码肯定是没有问题的，初始化中其实并没有调用这些方法，只是以函数指针的方式记录下来而已。ijkplayer 几乎完全由 c 实现，函数指针随处可见，方便编程。

二、配置

初始化后 IjkMediaPlayer 后，可以对其进行一系列配置，例如:

1
2
3
4
5
// 设置硬解码
mIjkMediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "mediacodec", 1);

// 设置 opensles 方式输出音频
mIjkMediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "opensles", 1);

setOption() 会调用到底层 ff_ffplay.c 的 ffp_set_option() 方法：

1
2
3
4
5
6
7
void ffp_set_option(FFPlayer *ffp, int opt_category, const char *name, const char *value) {
    if (!ffp)
        return;

    AVDictionary **dict = ffp_get_opt_dict(ffp, opt_category);
    av_dict_set(dict, name, value, 0);
}

AVDictionary 其实就是一个键值对数组，相当于 Java 中的 HashMap，av_dict_set 就相当于 put 方法，用来存储播放器的配置信息，FFPlayer 中就有如下 AVDictionary ：

1
2
3
4
5
6
AVDictionary *format_opts;      // 格式配置，解封装文件时（avformat_open_input）需传入
AVDictionary *codec_opts;       // 编解码器配置，打开编解码器时（avcodec_open2）需传入
AVDictionary *sws_dict;         // avfilter 视频相关配置
AVDictionary *player_opts;      // 播放相关配置
AVDictionary *swr_opts;         // 音频相关配置
AVDictionary *swr_preset_opts;

通过 setOption() 方法将一系列的播放器配置暂存到这些 AVDictionary 中，对于没有 map 容器的 c 语言，可以充分利用它来配置和定义播放器的参数。FFmpeg 中很多 API 就是依赖 AVDictionary 来传递参数的，比如上面提到的 avformat_open_input、avcodec_open2 接口。
FFPlayer 结构体中本身就有配置相关的成员变量的，比如控制音频输出设备的 “int opensles” 等，当我们调用一系列 setOption() 方法将播放配置存储在 player_opts 中后，该如何取出再赋值给成员变量呢？
这个情景是否似曾相似，JavaEE 开发中如何从传递的一系列键值中取出赋值给成员变量？ JavaEE 的 Struts2 可以实现自动映射转换，可以将互联网上收到的 “名称”和“值”的组合自动赋值给相应名称的变量。FFmpeg 中也实现了这样一套自动映射的机制，可以实现直接将 AVDictionary 赋值给结构体，只需调用：

1
int av_opt_set_dict(void *obj, struct AVDictionary **options);

当然这个结构体需要提前做一些处理，制定映射的规则，要在结构体中添加 AVClass 成员变量，且必须为第一个成员变量，然后对其初始化，比如 FFPlayer 结构体：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// 需要映射的成员变量
static const AVOption ffp_context_options[] = {
      { "mediacodec-avc",  "MediaCodec: enable H264", OPTION_OFFSET(mediacodec_avc),   OPTION_INT(0, 0, 1) },
      { "opensles",        "OpenSL ES: enable",       OPTION_OFFSET(opensles),         OPTION_INT(0, 0, 1) },
      // 省略...
}


const  AVClass  ffp_context_class = {
        .class_name       = "FFPlayer",                  
        .item_name        = ffp_context_to_name,           
        .option           = ffp_context_options,     // 将需要映射的成员变量记录到 AVClass 中
        .version          = LIBAVUTIL_VERSION_INT,
        .child_next       = ffp_context_child_next,
        .child_class_next = ffp_context_child_class_next,
};


ffplayer->av_class = &ffp_context_class;    // 使结构体可自动映射

这样处理后，就可以直接对 FFplayer 这个结构体进行整体赋值了，在 ff_ffplay.c 的 ffp_prepare_async_l 方法中就有这个逻辑：

1
av_opt_set_dict(ffp, &ffp->player_opts);

扩展阅读：

FFmpeg源代码简单分析：结构体成员管理系统-AVClass

FFmpeg源代码简单分析：结构体成员管理系统-AVOption

三、播放

先来回顾下播放器的整体流程：
播放器原理.png
在 视频相关的理论知识与基础概念 中简单总结过视频播放原理，播放器必然是通过多线程同时进行解封装、解码、视频渲染等工作的，对于 Ijkplayer 来说，开辟的线程如下：

所有的播放逻辑都位于 ff_ffplay.c 中，当对播放器设置视频源路径、解码方式、输出模式等播放选项后，就可以开始播放了， 播放入口方法为 ffp_prepare_async_l，此方法中调用了比较重要的两个方法：

1
2
3
4
5
// 打开音频输出设备
ffp->aout = ffpipeline_open_audio_output(ffp->pipeline, ffp);
...
// 创建音/视频数据解码前/后队列， 创建解封装和视频渲染线程
VideoState *is = stream_open(ffp, file_name, NULL);

在初始化时 IjkPlayer 将选择视频解码器、选择音频输出设备的方法以函数指针的形式记录下来，方便后面直接调用。ffpipeline_open_audio_output 方法即选择了音频输出方式为 opensles 或 AndroidTrack ，具体实现为 ffpipeline_android.c 的 func_open_audio_output 方法。
stream_open 方法则相当重要了，梳理一下该方法中涉及到的关键方法：
stream_open (1).png