ICS4.0.3创建NuPlayer的处理流程

ICS4.0.3中播放RTSP流媒体使用的播放器框架是NuPlayer，现在就分析创建NuPlayer的处理流程。

1.创建Nulayer所做的处理

在NuPlayerDriver::NuPlayerDriver()构造函数中：

1.1 创建了ALooper对象mLooper，并调用了 mLooper->start函数，优先级为PRIORITY_AUDIO。

在ALooper::start函数中循环执行ALooper::loop()函数，在loop函数中调用gLooperRoster.deliverMessage函数，

然后在ALooperRoster::deliverMessag函数中调用handler->onMessageReceived函数，最终执行了AHandler的子struct中的onMessageReceived函数，

处理具体消息；例如MyHandler的onMessageReceived函数，用于处理rtsp的消息。

1.2 创建了NuPlayer对象mPlayer，并调用 mLooper->registerHandler，把mPlayer注册到全局变量gLooperRoster的mHandlers成员vector中。

所有的AHandler对象都需要注册到全局变量gLooperRoster的mHandlers成员中。

2. NuPlayer::start处理的流程为以下顺序

2.1 MediaPlayer::start() -> MediaPlayerService::Client::start() ->

2.2 NuPlayerDriver::start()

在NuPlayerDriver::setDataSource中mState被设置为STOPPED状态，所以在start函数中执行了mPlayer->start()，调用到NuPlayer::start()函数

2.3 NuPlayer::start()

发送kWhatStart消息

2.4 NuPlayer::onMessageReceived对kWhatStart消息的处理

2.4.1 接收到kWhatStart消息后，先对一些变量赋初始值，并调用mSource->start()函数，对于rtsp流来说，即调用NuPlayer::RTSPSource::start()函数

2.4.1.1 NuPlayer::RTSPSource::start()

(1)创建了ALooper对象mLooper，并调用了mLooper->setName("rtsp")和mLooper->start()函数。

(2)创建了AHandlerReflector<RTSPSource>对象mReflector，并通过调用mLooper->registerHandler，把mReflector注册到全局变量gLooperRoster的mHandlers成员中

AHandlerReflector的作用暂时还不清楚，貌似是指定RTSPSource接收消息

(3)创建消息kWhatNotify，并做为MyHandler的参数，在NuPlayer::RTSPSource::onMessageReceived函数中处理了kWhatNotify消息

(4)创建MyHandler对象mHandler，并注册到gLooperRoster的mHandlers成员中

(5)执行mHandler->connect()，链接到服务器，并把mState设置为CONNECTING状态

调用ARTSPConnection的connect函数，进行链接服务器的处理。

2.4.2 新建Renderer对象mRenderer，并发送kWhatRendererNotify消息，把mRenderer注册到全局变量gLooperRoster的mHandlers成员中

Renderer构造函数只是简单的对变量赋默认值，并没有做其他处理

2.4.3 调用postScanSources()函数，进行初始化audio/video的解码器decoder

(1)NuPlayer::postScanSources()函数中发送了kWhatScanSources消息

2.5 NuPlayer::onMessageReceived对kWhatScanSources消息的处理

2.5.1 调用instantiateDecoder函数执行初始化video和audio解码器

instantiateDecoder(false, &mVideoDecoder);

    if (mAudioSink != NULL) {
        instantiateDecoder(true, &mAudioDecoder);
    }

2.5.2 NuPlayer::instantiateDecoder

(1)当初始化audio解码器时，发送kWhatAudioNotify消息

当初始化video解码器时，发送kWhatVideoNotify消息

(2)初始解码器Decoder对象decoder，并注册到全局变量gLooperRoster的mHandlers成员中

*decoder = audio ? new Decoder(notify) :
                       new Decoder(notify, mNativeWindow); // video时，设置NativeWindowWrapper参数
    looper()->registerHandler(*decoder);

    (*decoder)->configure(meta); // 调用decoder的configure方法，初始化ACodec解码器

2.5.3 NuPlayer::Decoder::configure

(1)创建消息kWhatCodecNotify，用于ACodec对象mCodec的通知消息

(2)调用makeFormat函数，根据meta类型，创建对应的message format

(3)创建ACodec对象mCodec，

(4)video解码时，创建ALooper对象mCodecLooper，用于释放主消息event队列，并注册到全局变量gLooperRoster的mHandlers成员中

mCodecLooper的name设置为"NuPlayerDecoder"

2.6 NuPlayer::onMessageReceived

case kWhatVideoNotify:

case kWhatAudioNotify:

取得AMessage消息"codec-request"对应的"what"值，分别对以下情况处理

2.6.1 ACodec::kWhatFillThisBuffer

执行feedDecoderInputData函数，取得一个有效的buffer

2.6.2 ACodec::kWhatEOS

向render发送EOS消息

mRenderer->queueEOS(audio, err);

2.6.3 ACodec::kWhatFlushCompleted

（1）把mFlushingAudio或mFlushingVideo设置为FLUSHED或者SHUTTING_DOWN_DECODER状态

（2）调用finishFlushIfPossible()函数，执行一些flush后的操作，例如：

mRenderer->signalTimeDiscontinuity();

mAudioDecoder->signalResume();

mVideoDecoder->signalResume();

finishReset();

如果mAudioDecoder == NULL || mVideoDecoder == NULL，则会执行postScanSources()函数，进行初始化audio/video的解码器decoder

2.6.4 ACodec::kWhatOutputFormatChanged

2.6.5 ACodec::kWhatShutdownCompleted

2.6.6 ACodec::kWhatError

2.6.7 ACodec::kWhatDrainThisBuffer // 在ACodec::BaseState::onOMXFillBufferDone中发送的

调用renderBuffer(audio, codecRequest)， 把需要解码的数据放入render队列

2.7 NuPlayer::renderBuffer

先做一些检查，丢弃需要跳过的数据

调用mRenderer->queueBuffer(audio, buffer, reply);，把真正需要解码的数据放入renderer队列

2.8 NuPlayer::Renderer::queueBuffer

发送kWhatQueueBuffer消息

sp<AMessage> msg = new AMessage(kWhatQueueBuffer, id());
    msg->setInt32("audio", static_cast<int32_t>(audio));
    msg->setObject("buffer", buffer);
    msg->setMessage("notifyConsumed", notifyConsumed);
    msg->post();

2.9 NuPlayer::Renderer::onMessageReceived

case kWhatQueueBuffer:

--->

NuPlayer::Renderer::onQueueBuffer

在video时，调用postDrainVideoQueue函数

--->

NuPlayer::Renderer::postDrainVideoQueue()

发送kWhatDrainVideoQueue消息，消息延迟时间为delayUs。

+++++++++++++++变量注解+++++++++++++++

mAnchorTimeMediaUs表示audio的媒体时间mediaTimeUs，初始值为-1
        mAnchorTimeMediaUs = mediaTimeUs;

            int64_t realTimeOffsetUs =
                (mAudioSink->latency() / 2  /* XXX */
                    + numFramesPendingPlayout
                        * mAudioSink->msecsPerFrame()) * 1000ll;

            // LOGI("realTimeOffsetUs = %lld us", realTimeOffsetUs);

            mAnchorTimeRealUs =
                ALooper::GetNowUs() + realTimeOffsetUs;
        mAnchorTimeRealUs表示audio的已经处理完(包括已经播放和正要播放)的数据的时间。如果没有audio，则为当前系统时间
            mAnchorTimeRealUs = ALooper::GetNowUs();

++++++++++++++++++++++++++++++

--->

NuPlayer::Renderer::onMessageReceived

case kWhatDrainVideoQueue:

调用onDrainVideoQueue()处理

继续调用postDrainVideoQueue函数，循环处理下一个buffer

--->

NuPlayer::Renderer::onDrainVideoQueue()
// 发送消息表示此buffer已经处理
    entry->mNotifyConsumed->setInt32("render", !tooLate);
    entry->mNotifyConsumed->post();
    mVideoQueue.erase(mVideoQueue.begin());
    entry = NULL;

    notifyPosition();

--------------------------------------------------------------------------------------------------

**************** 发送kWhatDrainThisBuffer消息的处理流程 Start ****************

NuPlayer::instantiateDecoder

创建Decoder对象，然后调用

(*decoder)->configure(meta);

--->

NuPlayer::Decoder::configure

调用mCodec->initiateSetup(format);

--->

ACodec::initiateSetup

发送kWhatSetup消息

--->

ACodec::UninitializedState::onMessageReceived

case ACodec::kWhatSetup:

调用onSetup(msg);

--->

ACodec::UninitializedState::onSetup
status_t err = omx->allocateNode(componentName.c_str(), observer, &node);

--->

OMX::allocateNode

创建了OMXNodeInstance对象，并注册了OMXNodeInstance::kCallbacks回调

--->

// static
OMX_CALLBACKTYPE OMXNodeInstance::kCallbacks = {
    &OnEvent, &OnEmptyBufferDone, &OnFillBufferDone // 注册了回调函数OnFillBufferDone
};

--->

OMX_ERRORTYPE OMXNodeInstance::OnFillBufferDone(
        OMX_IN OMX_HANDLETYPE hComponent,
        OMX_IN OMX_PTR pAppData,
        OMX_IN OMX_BUFFERHEADERTYPE* pBuffer) {
    OMXNodeInstance *instance = static_cast<OMXNodeInstance *>(pAppData);
    if (instance->mDying) {
        return OMX_ErrorNone;
    }
    return instance->owner()->OnFillBufferDone(instance->nodeID(), pBuffer); // OMXNodeInstance含有OMX成员变量OMX *mOwner;
}

--->

OMX::OnFillBufferDone

设置msg.type = omx_message::FILL_BUFFER_DONE;并发送

--->

ACodec::BaseState::onOMXMessage
    case omx_message::FILL_BUFFER_DONE:
        return onOMXFillBufferDone(
                            bufferID,
                            (size_t)rangeOffset, (size_t)rangeLength,
                            (OMX_U32)flags,
                            timeUs,
                            platformPrivate,
                            dataPtr);

--->

ACodec::BaseState::onOMXFillBufferDone
    PortMode mode = getPortMode(kPortIndexOutput);

    switch (mode) {
        case KEEP_BUFFERS:
            break;

        case RESUBMIT_BUFFERS:
        设置发送消息notify->setInt32("what", ACodec::kWhatDrainThisBuffer);

**************** 发送kWhatDrainThisBuffer消息的处理流程 End ****************