Provider（1）- 什么是AudioBufferProvider

什么是AudioBufferProvider？

顾名思义，Audio音频数据缓冲提供，就是提供音频数据的缓冲类，而且这个AudioBufferProvider派生出许多子类，每个子类有不同的用途，至关重要；那它在Android哪个地方使用呢？

在PlaybackTread中，接收应用层传递而来的数据，那为什么要专门用这么多Provider类来处理呢？而不只是简单的转发，将应用层的数据转发到PlaybackThread就行了；

No、No、No！因为PlaybackThread负责接收应用层诸多应用的音频数据，每个音源的数据format、channel等不同，需要进行不同format转换、channel扩张/裁剪、down/upMix等，甚至会对其数据做一些音频特性如变速等操作，这就要对数据进行预处理，每一个provider的派生类就是用来做这些的

AudioBufferProvider类派生关系图

整体框架图如上，类的大致用途在图片中已简单标识，简而言之，右侧SourceAudioBufferProvider是专用于数据提供，而左侧的BufferProvider则是对数据进行一些特殊处理，那系统是如何串联这些对象呢？那就和父类的virtual函数有关系，重点关注AudioBufferProvider和PassthruBufferProvider这两个祖先类

AudioBufferProvider

class AudioBufferProvider
{
public:
    // FIXME merge with AudioTrackShared::Buffer, AudioTrack::Buffer, and AudioRecord::Buffer
    //       and rename getNextBuffer() to obtainBuffer()
    struct Buffer {
        Buffer() : raw(NULL), frameCount(0) { }
        //联合体所有成员共用一个空间
        union {
            void*       raw;
            short*      i16;
            int8_t*     i8;
        };
        size_t frameCount;
    };
    // On entry:
    //  buffer              != NULL
    //  buffer->raw         unused
    //  buffer->frameCount  maximum number of desired frames
    // On successful return:
    //  status              NO_ERROR
    //  buffer->raw         non-NULL pointer to buffer->frameCount contiguous available frames
    //  buffer->frameCount  number of contiguous available frames at buffer->raw,
    //                      0 < buffer->frameCount <= entry value
    // On error return:
    //  status              != NO_ERROR
    //  buffer->raw         NULL
    //  buffer->frameCount  0
    //buffer.raw地址 buffer.frameCount长度,也就是数据是读出来，读到buffer中去
    virtual status_t getNextBuffer(Buffer* buffer) = 0;

始祖类AudioBufferProvider定义了数据Buffer结构体，而getNextBuffer就是获取音频数据的，调用此方法后数据会存到buffer参数中去；

PassthruBufferProvider工作模式—责任链模式

class PassthruBufferProvider : public AudioBufferProvider {
    virtual void setBufferProvider(AudioBufferProvider *p) {
        mTrackBufferProvider = p;
    }
    protected:
        AudioBufferProvider *mTrackBufferProvider;
}

上面是定义，可以按如下伪代码使用：

std::unique_ptr<PassthruBufferProvider> mAdjustChannelsBufferProvider = AdjustChannelsBufferProvider();
std::unique_ptr<PassthruBufferProvider> mReformatBufferProvider = ReformatBufferProvider().setsetBufferProvider(mAdjustChannelsBufferProvider);
std::unique_ptr<PassthruBufferProvider> mTimestretchBufferProvider = TimestretchBufferProvider().setsetBufferProvider(mReformatBufferProvider);

这样mAdjustChannelsBufferProvider处理完了，就交给mReformatBufferProvider处理，在交给mTimestretchBufferProvider处理，直至处理完成；

在Android中哪个地方使用？

哈哈，据我所知，目前在2个地方看到：

/framework/av/services/audioflinger/threads.cpp
/frameworks/av/media/libaudioprocessing/AudioMixer.cpp

在threads里面的threadLoop_write方法里面，通常写入到sink对象，如下：

ssize_t AudioFlinger::PlaybackThread::threadLoop_write()
{
    .....
    ssize_t framesWritten = mNormalSink->write((char *)mSinkBuffer + offset, count);
    ....
}

这里就是接收应用层的数据，通常是写入到SourceBufferProvider中去；mNormalSink是MonoPipe类型，而MonoPipe怎么又和SourceBufferProvider扯上关系了呢？见下图：

当write写入到MonoPipe中去了以后，在SourceBufferProvider中，虚函数使用getNextBuffer拉去数据即可

而在AudioMixer中，在混音时通常会创建许多BufferProvider，对音频数据进行预处理，如下：