Android音频系统之AudioFlinger(三)

http://blog.csdn.net/xuesen_lin/article/details/8805091

1.1.1 PlaybackThread的循环主体

当一个PlaybackThread进入主循环后(threadLoop),音频事务就正式开启了。仔细观察的话，我们会发现这个循环中会不断地调用以“threadLoop_”开头的若干接口，比如threadLoop_mix、threadLoop_sleepTime、threadLoop_standby等等。以这样的前缀开头，是因为这些函数都是在threadLoop这个主体里被调用的，可以说代表了这个PlaybackThread所需要完成的各个操作步骤。

从上一小节可以了解到，当程序执行到PlaybackThread::onFirstRef时会去真正启动一个线程承载运行threadLoop，接下来我们具体看下这个循环体的处理流程。

bool AudioFlinger::PlaybackThread::threadLoop()

{ …

while (!exitPending())/*Step1.*/

{   …

processConfigEvents();/*Step 2. */

{ /*把这段代码框起来的目的是限制自动锁变量_l的生命期，

从而灵活地实现了自动锁的控制范围*/

Mutex::Autolock  _l(mLock);

…

/*Step 3. Standby判断*/

if(CC_UNLIKELY((!mActiveTracks.size() && systemTime() > standbyTime)|| mSuspended> 0)) {

if (!mStandby){

threadLoop_standby();//调用设备的

mStandby =true;

mBytesWritten = 0;

}

…

}

/*Step 4.*/

mMixerStatus =prepareTracks_l(&tracksToRemove);

…

}

/*Step5.*/

if(CC_LIKELY(mMixerStatus == MIXER_TRACKS_READY)) {

threadLoop_mix();

} else {

threadLoop_sleepTime();

}

…

/*Step 6.*/

if (sleepTime == 0) {

threadLoop_write(); //不需要休眠，有数据要写

…

mStandby = false;

} else {

usleep(sleepTime);//进入休眠，时间长短是sleepTime

}

/*Step 7.*/

threadLoop_removeTracks(tracksToRemove);//移除相关Track

tracksToRemove.clear();…

}//while (!exitPending())结束

…

releaseWakeLock();

return false;

}

Step1@ PlaybackThread::threadLoop, 循环的条件是!exitPending()为true。这个函数属于Thread类，它主要通过判断内部变量mExitPending的值来得出是否要结束线程。变量mExitPending在Thread初始化时为fasle，如果后面有人通过requestExit()、requestExitAndWait等等来请求退出，这个值就会改变，从而使得PlaybackThread结束循环。

Step2@ PlaybackThread::threadLoop, 处理config事件。当有配置改变的事件发生时，可以通过sendConfigEvent来通知PlaybackThread。这个函数将把事件添加到mConfigEvents全局变量中，以供processConfigEvents进行处理。配置事件包括如下几种：

enum io_config_event {

OUTPUT_OPENED,//Output打开

OUTPUT_CLOSED,//Output关闭

OUTPUT_CONFIG_CHANGED,//Output配置改变

INPUT_OPENED, //Input打开

INPUT_CLOSED, //Input关闭

INPUT_CONFIG_CHANGED,//Input配置改变

STREAM_CONFIG_CHANGED,//Stream配置改变

NUM_CONFIG_EVENTS

};

Step3@ PlaybackThread::threadLoop,判断当前是否符合Standby的条件，如果是的话就调用threadLoop_standby。这个函数最终还是通过HAL层的接口来实现，如下：

mOutput->stream->common.standby(&mOutput->stream->common);

Step4@ PlaybackThread::threadLoop, 进行数据准备，prepareTracks_l这个函数非常长，我们先用伪代码的形式整理一下它所做的工作，如下所示：

AudioFlinger::PlaybackThread::mixer_stateAudioFlinger::MixerThread::prepareTracks_l(…)

{

/*Step 1. 当前活跃的Track数量*/

size_t  count = mActiveTracks.size();

/*Step 2. 循环处理每个Track，这是函数的核心*/

for (size_t i=0; i<count ; i++) {

Track* track =mActiveTracks[i];//伪代码没有考虑强指针

/*Step 3. FastTrack下的处理*/

if(track is FastTrack)

{

//dosomething;

}

/*Step 4. 准备数据，分为以下几个小部来完成*/

audio_track_cblk_t*cblk = track->cblk(); //Step 4.1 数据块准备

/*Step 4.2 要回放音频前，至少需要准备多少帧数据？*/

uint32_t  minFrames = 1;//初始化

//具体计算minFrames…

/*Step 4.3 如果数据已经准备完毕*/

//调整音量

//其它参数设置

}//for循环结束

/*Step 5. 后续判断*/

//返回结果，指明当前状态是否已经ready

}

现在我们针对上面的步骤来做“填空”。

Step1@ MixerThread::prepareTracks_l, mActiveTracks的数据类型是SortedVector，用于记录当前活跃的Track。它会随着新的AudioTrack的加入而扩大，也会在必要的情况下(AudioTrack工作结束、或者出错等等)remove相应的Track。

Step2&3@MixerThread::prepareTracks_l, 循环的条件就是要逐个处理该PlaybackThread中包含的Track。假如当前是一个FastTrack，我们还要做一些其它准备，这里就暂时不去涉及具体细节了。

Step4@ MixerThread::prepareTracks_l, 这一步是准备工作中最重要的，那就是缓冲数据。在学习代码细节前，我们先来了解数据传输时容易出现的underrun情况。

什么是BufferUnderrun呢？

当两个设备或进程间形成“生产者-消费者”关系时，如果生产的速度不及消费者消耗的速度，就会出现Underrun。以音频回放为例，此时用户听到的声音就可能是断断续续的，或者是重复播放当前buffer中的数据(取决于具体的实现)。

如何避免这种异常的发生？这也是Step4所要解决的问题，以下分为几个小步骤来看AudioFlinger是如何做到的。

Ø  Step4.1，取得数据块

audio_track_cblk_t*cblk = track->cblk();

关于audio_track_cblk_t的更多描述，可以参见后面数据流小节。

Ø  Step4.2 计算正确回放音频所需的最少帧数，初始值为1。

uint32_tminFrames = 1;

if((track->sharedBuffer() == 0) && !track->isStopped() &&!track->isPausing() &&

(mMixerStatusIgnoringFastTracks == MIXER_TRACKS_READY)) {

if(t->sampleRate() == (int)mSampleRate) {

minFrames = mNormalFrameCount;

} else {

minFrames =(mNormalFrameCount * t->sampleRate()) / mSampleRate + 1 + 1;

minFrames +=mAudioMixer->getUnreleasedFrames(track->name());

ALOG_ASSERT(minFrames <= cblk->frameCount);

}

}

当track->sharedBuffer()为0时，说明AudioTrack不是STATIC模式的，否则数据就是一次性传送的，可以参见AudioTrack小节的描述。全局变量mSampleRate 是通过mOutput->stream->common.get_sample_rate获得的，它是由HAL提供的，代表的是设备的Sampling rate。

如果两者一致的话，就采用mNormalFrameCount，这个值在readOutputParameters函数中进行初始化。如果两者不一致的话，就要预留多余的量做rounding(+1)和interpolation(+1)。另外，还需要考虑未释放的空间大小，也就是getUnreleasedFrames得到的。得出的minFrames必需小于数据块的总大小，因而最后有个ASSERT。通常情况下frameCount分配的是一个buffer的两倍，可以参见AudioTrack小节的例子。

Ø  Step4.3 数据是否准备就绪了？

上一步我们计算出了数据的最小帧值，即minFrames，接下来就该判断目前的情况是否符合这一指标了，代码如下所示：

if ((track->framesReady() >=minFrames) && track->isReady() &&!track->isPaused()&& !track->isTerminated())

{//数据准备就绪，并处于ready状态

mixedTracks++; //需要mix的Track数量增加1

…

/*计算音量值*/

uint32_t vl, vr,va; //三个变量分别表示左、右声道、Aux level音量

if(track->isMuted() || track->isPausing()||mStreamTypes[track->streamType()].mute) {

vl = vr = va =0; //当静音时，变量直接赋0

if (track->isPausing()) {

track->setPaused();

}

} else {

/*这里获得的是针对每个stream类型设置的音量值，也就是后面“音量调节”小节里最

后执行到的地方，在这里就起到作用了*/

float typeVolume =mStreamTypes[track->streamType()].volume;

float v =masterVolume * typeVolume; //主音量和类型音量的乘积

uint32_t  vlr = cblk->getVolumeLR(); //这里得到的vlr必须经过验证是否在合理范围内

vl = vlr &0xFFFF; //vlr的高低位分别表示vr和vl

vr = vlr>> 16;

if (vl >MAX_GAIN_INT) { //对vl进行合理值判断

ALOGV("Track left volume out of range: %04X", vl);

vl =MAX_GAIN_INT;

}

if (vr >MAX_GAIN_INT) {//对vr进行合理值判断

ALOGV("Track right volume out of range: %04X", vr);

vr =MAX_GAIN_INT;

}

// now applythe master volume and stream type volume

vl =(uint32_t)(v * vl) << 12;

vr =(uint32_t)(v * vr) << 12;

uint16_tsendLevel = cblk->getSendLevel_U4_12();

// send levelcomes from shared memory and so may be corrupt

if (sendLevel> MAX_GAIN_INT) {

ALOGV("Track send level out of range:%04X", sendLevel);

sendLevel= MAX_GAIN_INT;

}

va =(uint32_t)(v * sendLevel);

} …

mAudioMixer->setParameter(name, param, AudioMixer::VOLUME0, (void*)vl);

mAudioMixer->setParameter(name, param, AudioMixer::VOLUME1, (void*)vr);

mAudioMixer->setParameter(name, param, AudioMixer::AUXLEVEL, (void*)va);

…

} else {//数据未准备就绪，略过。。。

对于音量的设置还有很多细节，大家有兴趣的可以深入研究下。在得到vl、vr和va的值后，还需要把它们应用到AudioMixer中去，不过在prepareTracks_l中还只是调用mAudioMixer->setParameter设置了这些参数，真正的实现是在threadLoop_mix中，我们后面会讲到这个函数。

Step5@ MixerThread::prepareTracks_l, 通过对每个Track执行上述的处理后，最后要返回一个结果，这通常取决于：

①是否有activetrack

②active track的数据是否已经准备就绪

返回的最终值将影响到threadLoop的下一步操作。

完成了prepareTracks_l的分析，我们再回到前面的threadLoop。

Step5@ PlaybackThread::threadLoop, 如果上一步的数据准备工作已经完成(即返回值是MIXER_TRACKS_READY),就开始进行真正的混音操作，即threadLoop_mix，否则会休眠一定的时间——如此循环往复直到退出循环体。

void AudioFlinger::MixerThread::threadLoop_mix()

{

int64_t pts;

…

mAudioMixer->process(pts);

…

}

这样就进入AudioMixer的处理了，我们放在下一小节做统一分析。

假如数据还没有准备就绪，那么AudioFlinger将调用threadLoop_sleepTime来计算需要休眠多长时间(变量sleepTime)，并在threadLoop主循环的末尾(在remove track之前)执行usleep进入休眠。

Step6@ PlaybackThread::threadLoop, 将数据写到HAL中，从而逐步写入到硬件设备中。

void AudioFlinger::PlaybackThread::threadLoop_write()

{

mLastWriteTime =systemTime();

mInWrite = true;

int bytesWritten;

if (mNormalSink != 0) {

…

ssize_t framesWritten= mNormalSink->write(mMixBuffer, count);

…

} else {

bytesWritten =(int)mOutput->stream->write(mOutput->stream, mMixBuffer,mixBufferSize);

}

if (bytesWritten > 0)mBytesWritten += mixBufferSize;

mNumWrites++;

mInWrite = false;

}

分为两种情况：

Ø  如果是采用了NBAIO(Non-blocking AudioI/O)，即mNormalSink不为空，则通过它写入HAL

Ø  否则使用普通的AudioStreamOut(即mOutput变量)将数据输出

Step7@ PlaybackThread::threadLoop, 移除tracksToRemove中指示的Tracks。是否移除一个Track是在prepareTracks_l中判断中，可以概括为以下几种情况：

Ø  对于Fast Track，如果它的状态(mState)是STOPPING_2、PAUSED、TERMINATED、STOPPED、FLUSHED，或者状态是ACTIVE但underrun的次数超过限额(mRetryCount)，则会被加入tracksToRemove列表中

Ø  当前的Track数据未准备就绪的情况下,且是STATICTRACK或者已经停止/暂停，也会被加入tracksToRemove列表中

在tracksToRemove列表中的Track，与其相关的output将收到stop请求(由AudioSystem::stopOutput发起)。

关于AudioFlinger中与AudioTrack、AudioPolicyService有交互的部分，我们还将在后续小节进行阐述。