在macOS和iOS平台的音频开发中，Core Audio框架提供了底层的音频处理能力。其中，AudioQueue作为一套高层次的API，为开发者封装了复杂的硬件交互细节，使得音频的播放和录制变得相对可控。它主要通过维护一组缓冲区，并在适当的时机触发回调函数，让开发者能够专注于音频数据的生成与消费，而无需直接与底层硬件驱动打交道。
AudioQueue基础概念与工作原理
AudioQueue的核心在于将音频数据切分为多个固定大小的数据包，并将这些数据包放入缓冲区中排队等待处理。这种设计有效解耦了音频数据的产生速度与硬件的消费速度。在播放场景下，应用程序负责生成音频数据并填充到缓冲区，随后将缓冲区排入队列，底层的音频渲染器会按照顺序取出数据并进行播放；在录制场景下，硬件采集到足够的数据后填满缓冲区，并将其交还给应用程序进行存储或网络传输。这种生产者-消费者模型是理解AudioQueue运作机制的基础。
要使用AudioQueue，首先必须正确配置AudioStreamBasicDescription结构体，简称ASBD。这个结构体定义了音频数据的格式，包括采样率、声道数、位深度以及每帧包含的字节数等关键信息。如果ASBD配置错误，音频播放可能会出现变调、杂音甚至直接导致系统崩溃。例如，对于线性PCM格式的音频，我们需要明确指定mFormatID为kAudioFormatLinearPCM，并准确设置mBytesPerFrame和mFramesPerPacket等字段，确保数据对齐。在录制场景中，通常可以传入一个采样率为0的ASBD，系统会自动填充设备支持的最佳格式。
AudioQueue通过回调函数与应用程序进行交互。对于播放队列，当底层消费完一个缓冲区的数据时，会调用开发者注册的回调函数，通知应用程序该缓冲区已空闲，可以填充新的数据。对于录制队列，当硬件采集的数据填满一个缓冲区时，回调函数被触发，应用程序需要在此处将数据拷贝出来并持久化。理解这种基于数据驱动的回调机制，是掌握AudioQueue的关键。回调函数运行在独立的实时线程上，因此绝对不能在其中执行耗时操作或加锁等待，否则会直接导致音频出现爆音或卡顿。
实现音频播放与缓冲区管理
构建一个音频播放器，第一步是调用AudioQueueNewOutput函数创建一个新的输出队列。在创建过程中，我们需要传入前面配置好的ASBD结构体，以及自定义的回调函数指针。创建完成后，系统并不会自动分配缓冲区内存，开发者需要根据音频的时长和延迟要求，手动调用AudioQueueAllocateBuffer分配若干个缓冲区。通常建议分配3到5个缓冲区，以在内存占用和抗延迟之间取得平衡。缓冲区太小或太少容易导致数据供应不及时，而太大则会增加启动延迟。
缓冲区分配好后，需要手动触发第一次数据填充。开发者需要实现一个辅助函数，读取音频文件数据并填充到缓冲区中，然后调用AudioQueueEnqueueBuffer将该缓冲区排入队列。当队列中存在数据后，调用AudioQueueStart即可开始播放。此后，系统会进入一个自动循环：消费数据、触发回调、填充新数据、再次入队。下面是一个典型的播放回调函数实现示例，展示了如何从音频文件中持续读取数据并喂给队列。
// 播放队列回调函数
static void AQOutputCallback(void *inUserData, AudioQueueRef inAQ, AudioQueueBufferRef inBuffer) {
// 转换自定义数据结构
AudioPlayerState *pAqData = (AudioPlayerState *)inUserData;
// 如果停止播放，则直接返回
if (pAqData->mIsRunning == 0) return;
// 读取音频文件数据并填充到inBuffer中
UInt32 numBytes;
UInt32 numPackets = pAqData->mNumPacketsToRead;
// 从文件中读取指定数量的包
OSStatus result = AudioFileReadPackets(pAqData->mAudioFile, false, &numBytes, pAqData->mPacketDescs, pAqData->mCurrentPacket, &numPackets, inBuffer->mAudioData);
if (numPackets > 0) {
// 更新当前读取位置
pAqData->mCurrentPacket += numPackets;
// 设置缓冲区实际数据大小
inBuffer->mAudioDataByteSize = numBytes;
// 将填充好数据的缓冲区重新排入队列
AudioQueueEnqueueBuffer(pAqData->mQueue, inBuffer, 0, pAqData->mPacketDescs);
} else {
// 文件读取完毕，停止队列
AudioQueueStop(pAqData->mQueue, false);
pAqData->mIsRunning = 0;
}
}
在上述代码中，回调函数接收一个用户自定义的数据结构指针，该结构通常包含了AudioFile实例、当前读取位置等信息。通过AudioFileReadPackets读取数据后，必须更新inBuffer的mAudioDataByteSize字段，以告知系统本次填充了多少有效数据。如果读取到的数据包数量为零，说明文件已经播放完毕，此时应调用AudioQueueStop停止播放。需要注意的是，在回调函数中执行的操作必须尽可能轻量，任何阻塞操作都会打断音频流的连续性。当需要销毁队列时，应先调用AudioQueueStop，再调用AudioQueueDispose释放资源，系统会自动释放通过AudioQueueAllocateBuffer分配的内存。
录制音频与回调函数处理
音频录制的流程与播放类似，但数据流向相反。首先通过AudioQueueNewInput创建输入队列，同样需要配置ASBD和回调函数。在录制场景下，ASBD通常使用设备默认的输入格式，或者将其转换为便于存储的格式。分配缓冲区后，调用AudioQueueEnqueueBuffer将空缓冲区排入队列，等待硬件填充。当调用AudioQueueStart后，硬件开始采集数据，一旦填满一个缓冲区，就会触发回调。在停止录制时，需要特别注意处理缓冲区中可能残留的半满数据，以免丢失最后几帧音频。
在录制回调中，应用程序需要将inBuffer->mAudioData中的数据拷贝出来，写入到本地文件或发送到网络。由于回调函数运行在Core Audio的实时线程上，直接在此线程中进行磁盘I/O操作是极其危险的，可能会导致严重的音频延迟甚至丢数据。为了解决这个问题，通常的做法是在回调函数中仅仅将音频数据拷贝到一个环形缓冲区中，然后通过信号量唤醒另一个专门的写入线程来处理文件写入操作。下面是一个简化的录制回调函数示例，直接演示了数据写入文件的过程。
// 录制队列回调函数
static void AQInputCallback(void *inUserData, AudioQueueRef inAQ, AudioQueueBufferRef inBuffer, const AudioTimeStamp *inStartTime, UInt32 inNumPackets, const AudioStreamPacketDescription *inPacketDesc) {
AudioRecorderState *pState = (AudioRecorderState *)inUserData;
// 如果未在录制状态，直接回收缓冲区
if (!pState->isRecording) {
AudioQueueEnqueueBuffer(pState->queue, inBuffer, 0, NULL);
return;
}
// 将数据写入文件（注意：实际生产环境应使用独立线程处理I/O）
if (inNumPackets > 0) {
// 写入音频文件
AudioFileWritePackets(pState->audioFile, false, inBuffer->mAudioDataByteSize, inPacketDesc, pState->currentPacket, &inNumPackets, inBuffer->mAudioData);
pState->currentPacket += inNumPackets;
}
// 将空缓冲区重新排入队列，继续接收数据
AudioQueueEnqueueBuffer(pState->queue, inBuffer, 0, NULL);
}
上述代码展示了录制回调的基本逻辑。在回调函数中，我们首先检查录制状态，如果用户已经停止录制，则直接将缓冲区回收。如果正在录制，则利用AudioFileWritePackets将数据写入磁盘。写入完成后，必须立即调用AudioQueueEnqueueBuffer将刚刚消费完的缓冲区重新排入队列，否则硬件将没有可用的缓冲区来存放新采集的数据，从而导致录制中断。合理管理缓冲区的生命周期，是保证音频录制连续性的核心所在。通过深入理解AudioQueue的这些底层机制，开发者可以构建出高度定制化的音频处理管线，满足各种复杂场景的需求。
macOS Core AudioAudioQueue缓冲区管理修改时间：2026-08-26 00:57:05