类AudioTrack的函数getMinFrameCount(java侧为getMinBufferSize)

以前看这个函数的时候，对min frame是如何计算得来的，并不是很了解。

今天又看了看，终于有点头绪了。

status_t AudioTrack::getMinFrameCount(        int* frameCount,        int streamType,        uint32_t sampleRate){    int afSampleRate;    if (AudioSystem::getOutputSamplingRate(&afSampleRate, streamType) != NO_ERROR) {        return NO_INIT;    }    int afFrameCount;    if (AudioSystem::getOutputFrameCount(&afFrameCount, streamType) != NO_ERROR) {        return NO_INIT;    }    uint32_t afLatency;    if (AudioSystem::getOutputLatency(&afLatency, streamType) != NO_ERROR) {        return NO_INIT;    }    // Ensure that buffer depth covers at least audio hardware latency    uint32_t minBufCount = afLatency / ((1000 * afFrameCount) / afSampleRate);    if (minBufCount < 2) minBufCount = 2;    *frameCount = (sampleRate == 0) ? afFrameCount * minBufCount :              afFrameCount * minBufCount * sampleRate / afSampleRate;    return NO_ERROR;}

先看看下面这一段代码：

    int afSampleRate;    if (AudioSystem::getOutputSamplingRate(&afSampleRate, streamType) != NO_ERROR) {        return NO_INIT;    }

从字面意思上，也基本上可以看出来，是去获取output 设备的sampling rate的。
如何获取到的呢？
一步一步来吧。


函数AudioSystem::getOutputSamplingRate中会首先根据stream type获取对应的output，然后尝试获取output的描述。
若获取成功，取output描述的samplerate：

        *samplingRate = outputDesc->samplingRate;

否则，取AudioFlinger的sample rate：

        *samplingRate = af->sampleRate(output);

先看audio flinger的sample rate是如何取得的。


函数AudioFlinger::sampleRate中，找到output对应的thread，取对应thread的sample rate。


函数AudioFlinger::ThreadBase::sampleRate中直接返回了成员变量mSampleRate。


mSampleRate是在函数AudioFlinger::PlaybackThread::readOutputParameters中被赋值：

    mSampleRate = mOutput->sampleRate();

mOutput->sampleRate，真正调用的是AudioStreamOutALSA对象的函数。
函数定义在其父类ALSAStreamOps中：

uint32_t ALSAStreamOps::sampleRate() const{    return mHandle->sampleRate;}

mHandle的赋值在ALSAStreamOps的构造函数中。使用的是构造函数参数handle。
AudioStreamOutALSA对象中函数AudioHardwareALSA::openOutputStream被创建：

            out = new AudioStreamOutALSA(this, &(*it));

其中it即为构造函数参数handle。
it的赋值：

ALSAHandleList::iterator it = mDeviceList.begin();

mDeviceList的赋值在AudioHardwareALSA的构造函数中：

            mALSADevice->init(mALSADevice, mDeviceList);

init函数其实就是s_init函数：

static status_t s_init(alsa_device_t *module, ALSAHandleList &list){    LOGD("Initializing devices for IMX51 ALSA module");    list.clear();    for (size_t i = 0; i < ARRAY_SIZE(_defaults); i++) {        _defaults[i].module = module;        list.push_back(_defaults[i]);    }    return NO_ERROR;}

_defaults的定义：

static alsa_handle_t _defaults[] = {    {        module      : 0,        devices     : IMX51_OUT_DEFAULT,        curDev      : 0,        curMode     : 0,        handle      : 0,        format      : SND_PCM_FORMAT_S16_LE, // AudioSystem::PCM_16_BIT        channels    : 2,        sampleRate  : DEFAULT_SAMPLE_RATE,        latency     : 200000, // Desired Delay in usec        bufferSize  : 6144, // Desired Number of samples        modPrivate  : (void *)&setDefaultControls,    },    {        module      : 0,        devices     : IMX51_IN_DEFAULT,        curDev      : 0,        curMode     : 0,        handle      : 0,        format      : SND_PCM_FORMAT_S16_LE, // AudioSystem::PCM_16_BIT        channels    : 2,        sampleRate  : DEFAULT_SAMPLE_RATE,        latency     : 250000, // Desired Delay in usec        bufferSize  : 6144, // Desired Number of samples        modPrivate  : (void *)&setDefaultControls,    },};

sampleRate原来是在这儿指定的：

        sampleRate  : DEFAULT_SAMPLE_RATE,

DEFAULT_SAMPLE_RATE的定义为44100.


所以，afSampleRate的值其实就是44100.


回头看看，若是在函数AudioSystem::getOutputSamplingRate中找到了output的描述，情况又是怎样的呢？


output描述是在AudioPolicyManagerBase的构造函数中被创建。
其中，latency是通过调用函数mpClientInterface->openOutput取得：

    mHardwareOutput = mpClientInterface->openOutput(&outputDesc->mDevice,                                    &outputDesc->mSamplingRate,                                    &outputDesc->mFormat,                                    &outputDesc->mChannels,                                    &outputDesc->mLatency,                                    outputDesc->mFlags);

其实就是调用了函数AudioFlinger::openOutput。
其中对SamplingRate的赋值：

        if (pSamplingRate) *pSamplingRate = samplingRate;

samplingRate的来历：

    AudioStreamOut *output = mAudioHardware->openOutputStream(*pDevices,                                                             (int *)&format,                                                             &channels,                                                             &samplingRate,                                                             &status);

函数AudioHardwareALSA::openOutputStream中对samplingRate的赋值：

            err = out->set(format, channels, sampleRate);

函数ALSAStreamOps::set中对sampleRate的处理：

    if (rate && *rate > 0) {        if (mHandle->sampleRate != *rate)            return BAD_VALUE;    } else if (rate)        *rate = mHandle->sampleRate;

与前面的那条河流汇合了。




FrameCount与sampleRate的流程类似，下面只说是其中不同的地方。
AudioFlinger::PlaybackThread::readOutputParameters函数中：

    mFrameSize = (uint16_t)mOutput->frameSize();    mFrameCount = mOutput->bufferSize() / mFrameSize;

函数frameSize来自于类AudioStreamOut：

    /**     * return the frame size (number of bytes per sample).     */    uint32_t    frameSize() const { return AudioSystem::popCount(channels())*((format()==AudioSystem::PCM_16_BIT)?sizeof(int16_t):sizeof(int8_t)); }

函数ALSAStreamOps::channels的实现：

uint32_t ALSAStreamOps::channels() const{    unsigned int count = mHandle->channels;    uint32_t channels = 0;    if (mHandle->curDev & AudioSystem::DEVICE_OUT_ALL)        switch(count) {            case 4:                channels |= AudioSystem::CHANNEL_OUT_BACK_LEFT;                channels |= AudioSystem::CHANNEL_OUT_BACK_RIGHT;                // Fall through...            default:            case 2:                channels |= AudioSystem::CHANNEL_OUT_FRONT_RIGHT;                // Fall through...            case 1:                channels |= AudioSystem::CHANNEL_OUT_FRONT_LEFT;                break;        }    else        switch(count) {            default:            case 2:                channels |= AudioSystem::CHANNEL_IN_RIGHT;                // Fall through...            case 1:                channels |= AudioSystem::CHANNEL_IN_LEFT;                break;        }    return channels;}

看看channels在_defaults中的定义：

        channels    : 2,

函数ALSAStreamOps::format实现：

int ALSAStreamOps::format() const{    int pcmFormatBitWidth;    int audioSystemFormat;    snd_pcm_format_t ALSAFormat = mHandle->format;    pcmFormatBitWidth = snd_pcm_format_physical_width(ALSAFormat);    switch(pcmFormatBitWidth) {        case 8:            audioSystemFormat = AudioSystem::PCM_8_BIT;            break;        default:            LOG_FATAL("Unknown AudioSystem bit width %i!", pcmFormatBitWidth);        case 16:            audioSystemFormat = AudioSystem::PCM_16_BIT;            break;    }    return audioSystemFormat;}

看看format在_defaults中的定义：

        format      : SND_PCM_FORMAT_S16_LE, // AudioSystem::PCM_16_BIT

PCM_8_BIT与PCM_16_BIT的定义：

    // Audio sub formats (see AudioSystem::audio_format).    enum pcm_sub_format {        PCM_SUB_16_BIT          = 0x1, // must be 1 for backward compatibility        PCM_SUB_8_BIT           = 0x2, // must be 2 for backward compatibility    };

所以，

    mFrameSize = (uint16_t)mOutput->frameSize();

的结果其实就是4.

函数ALSAStreamOps::bufferSize的实现：

size_t ALSAStreamOps::bufferSize() const{    snd_pcm_uframes_t bufferSize = mHandle->bufferSize;    snd_pcm_uframes_t periodSize;// 掉进了难缠的alsa lib，先不去看了。    snd_pcm_get_params(mHandle->handle, &bufferSize, &periodSize);    size_t bytes = static_cast<size_t>(snd_pcm_frames_to_bytes(mHandle->handle, bufferSize));    // Not sure when this happened, but unfortunately it now    // appears that the bufferSize must be reported as a    // power of 2. This might be for OSS compatibility.    for (size_t i = 1; (bytes & ~i) != 0; i<<=1)        bytes &= ~i;    return bytes;}

看看bufferSize在_defaults中的定义：

        bufferSize  : 6144, // Desired Number of samples

所以，不考虑alsa lib，下面：

    mFrameCount = mOutput->bufferSize() / mFrameSize;

的运算结果为：6144 / 4 = 1536
即afFrameCount为1536.


关于latency的流程就不再看了。
在_defaults中，latency的定义为：

        latency     : 200000, // Desired Delay in usec

根据以下计算公式：

#define USEC_TO_MSEC(x) ((x + 999) / 1000)

可以算得，afLatency的结果其实就是200.


变量的值都知道了，所以minBufCount也就可以算出来了：

    // Ensure that buffer depth covers at least audio hardware latency    uint32_t minBufCount = afLatency / ((1000 * afFrameCount) / afSampleRate);

minBufCount = 200 / （（1000×1536）/44100） = 5.


消化消化。
afFrameCount的意思是硬件buffer里能放多少frame，afFrameCount/afSampleRate的意思是，播放一次硬件buffer中的数据需要多少时间，算出来的单位是秒。
再乘以个1000，即将秒转为了毫秒。
这样就与afLatency的单位一致了。
这样算出来的结果，就是说，为了满足硬件延迟，软件侧的buffer大小只是要是硬件侧buffer大小的多少倍。


感觉还是没消化彻底。
什么是硬件延迟？为什么软件侧的buffer size需要这个倍数呢？
硬件延迟，就是说，硬件侧可能会延迟这么久，也就是说硬件可能有这么长的时间都没有从软件侧取数据。
而软件侧还在不停地写数据，为了保证软件侧的数据不被丢失，就需要软件侧的buffer足够大。
多大才是足够大呢？
就是在硬件允许的最大时间，不取数据的情况下，软件侧的buffer也不至于爆仓。
这样基本上消化彻底了。


frameCount的计算与传入参数sampleRate有关：

    *frameCount = (sampleRate == 0) ? afFrameCount * minBufCount :              afFrameCount * minBufCount * sampleRate / afSampleRate;

如果sampleRate为0，frameCount为 7680.
如果sampleRate不为0，frameCount为7680×sampleRate/44100.


消化一下。
既然上面已经算出来了软件buffer 大小只是要是硬件的多少倍，而硬件buffer中包含的frame个数已经知道为afFrameCount，
算出软件buffer中包含多少frame也没什么困难了。
如果软件侧过来的数据与硬件侧的sampling rate未指定，或者与硬件侧的一样，软件侧的buffer能装的frame个数即为afFrameCount * minBufCount。
如果软件侧的sampling rate与硬件侧不一致，就拿上面的结果再乘以个sampleRate / afSampleRate即可。