Android StagefrightPlayer调用流程

从Android 2.3开始，Android MediaPlayer采用Stagefright框架。Based on Android 4.0.1.

StagefrightPlayer创建函数如下：（MediaPlayerService.cpp，详细过程见文章:Android Audio 数据流详解）

static sp<MediaPlayerBase> createPlayer(player_type playerType, void* cookie,
        notify_callback_f notifyFunc)
{
    sp<MediaPlayerBase> p;
    switch (playerType) {
        case SONIVOX_PLAYER:
            LOGV(" create MidiFile");
            p = new MidiFile();
            break;
        case STAGEFRIGHT_PLAYER:
            LOGV(" create StagefrightPlayer");
            p = new StagefrightPlayer;
            break;
        case NU_PLAYER:
            LOGV(" create NuPlayer");
            p = new NuPlayerDriver;
            break;
        case TEST_PLAYER:
            LOGV("Create Test Player stub");
            p = new TestPlayerStub();
            break;
        default:
            LOGE("Unknown player type: %d", playerType);
            return NULL;
    }
    if (p != NULL) {
        if (p->initCheck() == NO_ERROR) {
            p->setNotifyCallback(cookie, notifyFunc);
        } else {
            p.clear();
        }
    }
    if (p == NULL) {
        LOGE("Failed to create player object");
    }
    return p;
}

首先了解下系统本身的调用流程，StagefrightPlayer使用的AwesomePlayer来实现的，首先是Demuxer的实现，对于系统本身不支持的格式是没有分离器的，具体查看代码（本文以本地文件播放为例）.

1. Demuxer的实现
Awesomeplayer.cpp的setDataSource_l(
  const sp<DataSource> &dataSource) {
  sp<MediaExtractor> extractor = MediaExtractor::Create(dataSource);

这个就是创建Demux的地方，查看代码MediaExtractor.cpp的create函数，datasource的sniff函数就是自动检测媒体格式容器的类型的，如果需要新增原系统无法识别的媒体格式，必然无法得到有效的分离器，所以这里需要自己创建自己Demuxer，每一种格式的XXXXExtractor.cpp函数中有个SniffXXXX函数，在Awesomeplayer的构造函数中的这一句DataSource::RegisterDefaultSniffers()就是注册好所有的sniff函数，写一个自己的XXXExtractor类，照样写个XXXXsinff函数，在RegisterDefaultSniffers中加入自己的函数。然后自已实现一个需要的Demuxer.通过Demuxer分离出音视频流后，就是进入解码阶段了。

 

2. AV Decoder

status_t AwesomePlayer::initVideoDecoder() {
  mVideoSource = OMXCodec::Create(
  mClient.interface(), mVideoTrack->getFormat(),
  false, 
  mVideoTrack);
这个就是创建的解码器了，create的最后一个参数就是分离出来的独立的视频流，具备的接口最重要的就是read接口，是分离器中实现的，这个track是XXXXExtractor中的getTrack获取的。

解码器的逻辑主要集中在OMXCodec.cpp中，在OMXCodec::Create中主要负责寻找匹配的codec并创建codec.

寻找匹配的codec:

    Vector<String8> matchingCodecs;
    findMatchingCodecs(
            mime, createEncoder, matchComponentName, flags, &matchingCodecs);

    if (matchingCodecs.isEmpty()) {
        return NULL;
    }

创建codec:

        status_t err = omx->allocateNode(componentName, observer, &node);
        if (err == OK) {
            LOGV("Successfully allocated OMX node '%s'", componentName);

            sp<OMXCodec> codec = new OMXCodec(
                    omx, node, quirks, flags,
                    createEncoder, mime, componentName,
                    source, nativeWindow);

            observer->setCodec(codec);

            err = codec->configureCodec(meta);

            if (err == OK) {
                if (!strcmp("OMX.Nvidia.mpeg2v.decode", componentName)) {
                    codec->mFlags |= kOnlySubmitOneInputBufferAtOneTime;
                }

                return codec;
            }

            LOGV("Failed to configure codec '%s'", componentName);
        }

findMatchingCodecs这个函数就是查找解码器的，它在kDecoderInfo数组中寻找需要的解码器。

 

void OMXCodec::findMatchingCodecs(
        const char *mime,
        bool createEncoder, const char *matchComponentName,
        uint32_t flags,
        Vector<String8> *matchingCodecs) {
    matchingCodecs->clear();

    for (int index = 0;; ++index) {
        const char *componentName;

        if (createEncoder) {
            componentName = GetCodec(
                    kEncoderInfo,
                    sizeof(kEncoderInfo) / sizeof(kEncoderInfo[0]),
                    mime, index);
        } else {
            componentName = GetCodec(
                    kDecoderInfo,
                    sizeof(kDecoderInfo) / sizeof(kDecoderInfo[0]),
                    mime, index);
        }

        if (!componentName) {
            break;
        }

        // If a specific codec is requested, skip the non-matching ones.
        if (matchComponentName && strcmp(componentName, matchComponentName)) {
            continue;
        }

        // When requesting software-only codecs, only push software codecs
        // When requesting hardware-only codecs, only push hardware codecs
        // When there is request neither for software-only nor for
        // hardware-only codecs, push all codecs
        if (((flags & kSoftwareCodecsOnly) &&   IsSoftwareCodec(componentName)) ||
            ((flags & kHardwareCodecsOnly) &&  !IsSoftwareCodec(componentName)) ||
            (!(flags & (kSoftwareCodecsOnly | kHardwareCodecsOnly)))) {

            matchingCodecs->push(String8(componentName));
        }
    }

    if (flags & kPreferSoftwareCodecs) {
        matchingCodecs->sort(CompareSoftwareCodecsFirst);
    }
}

差不多流程是这样把，关于显示部分就不用管了，解码器对接render部分，应该自己会弄好，解码器最重要的对外接口也就是read接口的，返回的一帧帧的解码后的数据，