FFmpeg API 之 AVAudioFifo

AVAudioFifo是一个缓冲区，它以一次音频采样为基本单位，是一个先进先出的队列。有了它，对音频的采样数据做缓冲就会变得非常简单，其优势有两点：一，它让我们在采样层面做操作，而不是更底层的字节层面；二，它支持多种格式的单次采样，如支持planar或packed的采样格式，支持不同的通道数等等。

AVAudioFifo的操作相对简单，我们看一下其相关的API。

首先是分配和释放操作：

//分配一个AVAudioFifo。
//sample_fmt和channels指定单次采样的参数
//nb_samples则指定AVAudioFifo的缓冲区大小。
AVAudioFifo *av_audio_fifo_alloc(enum AVSampleFormat sample_fmt, int channels,int nb_samples);

//重新分配缓冲区大小
//成功返回0，失败返回负的错误值
int av_audio_fifo_realloc(AVAudioFifo *af, int nb_samples);

//释放AVAudioFifo
void av_audio_fifo_free(AVAudioFifo *af);

然后是读写操作：

//将采样写入到AVAudioFifo
//成功则返回实际写入的采样数（实际上如果写入成功，返回值必定等于nb_samples），失败返回负的错误值
int av_audio_fifo_write(AVAudioFifo *af, void **data, int nb_samples);

//peek：读取数据，但读到的数据并不会从fifo中删除
int av_audio_fifo_peek(AVAudioFifo *af, void **data, int nb_samples);

//从指定的偏移位置peek数据
int av_audio_fifo_peek_at(AVAudioFifo *af, void **data, int nb_samples, int offset);

//读取数据，读到的数据会从fifo中删除
int av_audio_fifo_read(AVAudioFifo *af, void **data, int nb_samples);

//从fifo中删除nb_samples个采样
int av_audio_fifo_drain(AVAudioFifo *af, int nb_samples);

//删除fifo中的所有采样，情空
void av_audio_fifo_reset(AVAudioFifo *af);

最后是查看操作：

//返回fifo中当前存储的采样数量
int av_audio_fifo_size(AVAudioFifo *af);

//返回fifo中当前可写的采样数量，即尚未使用的空间数量
int av_audio_fifo_space(AVAudioFifo *af);

//同一时刻，以上两个函数的返回值之和等于fifo的缓冲区大小