Swift中AudioQueue复用缓冲区失效问题求助

看起来你遇到的核心问题是缓冲区尺寸过小导致的AudioQueue调度异常，再加上单帧填充的方式让音频输出出现间隙或无法持续调度。我们一步步拆解问题并给出修复方案：

一、核心问题分析 #

1. 极小缓冲区导致调度失效：你当前每个缓冲区仅包含1帧音频数据（mFramesPerPacket=1，分配缓冲区时用了format.mBytesPerFrame），AudioQueue处理这么小的缓冲区时，调度开销极大，很难及时完成缓冲区的复用与重新入队——这就是为什么只有当缓冲区数量足够多（一次性入队大量帧）时才能短暂播放，数量少或多到超出调度能力时就会中断、卡顿。
2. 初始咔哒声：单帧缓冲区的播放间隙会产生电平突变，即使第一帧是0相位，频繁的缓冲区切换也会导致输出出现咔哒声。
3. 相位计算逻辑不匹配缓冲区大小：你的offset每次只加1（对应1帧），但如果后续调整了缓冲区大小，这个逻辑会导致相位计算错误，音频频率偏离预期。

二、具体修复步骤 #

1. 调整缓冲区大小，设置合理的单缓冲区帧数量 #

选择一个适合AudioQueue调度的帧数量（比如2048或4096，这是音频处理中常用的缓冲区大小），平衡延迟与调度效率。

修改Synthesizer的初始化代码，增加缓冲区帧数量的参数：

class Synthesizer {
    // 新增：每个缓冲区包含的帧数量
    private let framesPerBuffer: UInt32 = 2048
    
    init(sampleRate: Double = 44100, channels: Int = 2, bufferCount: Int = 3) {
        assert(bufferCount > 2, "Need at least three buffers!")
        self.sampleRate = sampleRate
        self.channels = channels
        self.outputBuffers = Array<AudioQueueBufferRef?>(repeating: nil, count: bufferCount)
        
        let uChannels = UInt32(channels)
        let channelBytes = UInt32(MemoryLayout<Int16>.size)
        let bytesPerFrame = uChannels * channelBytes
        
        self.format = AudioStreamBasicDescription(
            mSampleRate: Float64(sampleRate),
            mFormatID: kAudioFormatLinearPCM,
            mFormatFlags: kAudioFormatFlagIsSignedInteger | kAudioFormatFlagIsPacked,
            mBytesPerPacket: bytesPerFrame,
            mFramesPerPacket: 1,
            mBytesPerFrame: bytesPerFrame,
            mChannelsPerFrame: uChannels,
            mBitsPerChannel: channelBytes * 8,
            mReserved: 0
        )
    }
}

2. 分配缓冲区时使用正确的字节数 #

在createAudioQueue中，计算每个缓冲区的总字节数为framesPerBuffer * format.mBytesPerFrame，而不是单帧的字节数：

private func createAudioQueue() throws {
    // ... 原有代码 ...
    for i in 0 ..< outputBuffers.count {
        let bufferByteSize = framesPerBuffer * format.mBytesPerFrame
        let createBufferResult = AudioQueueAllocateBuffer(outputQueue, bufferByteSize, &outputBuffers[i])
        
        if createBufferResult != 0 {
            throw Errors.coreAudioError(createBufferResult)
        }
        
        guard let outputBuffer = outputBuffers[i] else {
            throw Errors.couldNotInitialiseAudioQueue
        }
        
        synthesizerCallback(userData: selfPointer, audioQueue: outputQueue, buffer: outputBuffer)
    }
    // ... 原有代码 ...
}

3. 修改write函数，填充整个缓冲区的所有帧 #

现在每个缓冲区要填充framesPerBuffer帧数据，同时更新offset的逻辑，确保相位计算连续：

func write(withAudioQueue audioQueue: AudioQueueRef, toBuffer buffer: AudioQueueBufferRef) {
    let channelBytes = MemoryLayout<Int16>.stride
    let bytesPerFrame = channelBytes * channels
    let totalBytes = Int(framesPerBuffer) * bytesPerFrame
    
    // 转换为可写的Int16指针
    guard let bufferData = buffer.pointee.mAudioData.bindMemory(to: Int16.self, capacity: totalBytes / channelBytes) else {
        return
    }
    
    var currentOffset = offset
    for frameIndex in 0..<Int(framesPerBuffer) {
        // 计算当前帧的相位
        let phase = currentOffset / sampleRate * 10000 * Double.pi * 2
        let sampleValue = Int16(sin(phase) * Double(Int16.max))
        
        // 填充所有声道
        for channel in 0..<channels {
            bufferData[frameIndex * channels + channel] = sampleValue
        }
        
        currentOffset += 1
    }
    
    // 更新全局offset
    offset = currentOffset
    
    buffer.pointee.mAudioDataByteSize = UInt32(totalBytes)
    
    let enqueueResult = AudioQueueEnqueueBuffer(audioQueue, buffer, 0, nil)
    if enqueueResult != 0 {
        print("Enqueue error: \(enqueueResult)")
    }
}

4. 消除初始咔哒声：添加淡入处理 #

在初始化时增加一个淡入计数器，前几帧（比如前2048帧）的音量从0线性提升到最大，避免突然的电平变化：

class Synthesizer {
    // ... 原有属性 ...
    private var fadeInFrames: Int = 2048 // 淡入的总帧数
    
    // ... 原有代码 ...
    
    func write(withAudioQueue audioQueue: AudioQueueRef, toBuffer buffer: AudioQueueBufferRef) {
        let channelBytes = MemoryLayout<Int16>.stride
        let bytesPerFrame = channelBytes * channels
        let totalBytes = Int(framesPerBuffer) * bytesPerFrame
        
        guard let bufferData = buffer.pointee.mAudioData.bindMemory(to: Int16.self, capacity: totalBytes / channelBytes) else {
            return
        }
        
        var currentOffset = offset
        for frameIndex in 0..<Int(framesPerBuffer) {
            let phase = currentOffset / sampleRate * 10000 * Double.pi * 2
            var sampleValue = Int16(sin(phase) * Double(Int16.max))
            
            // 淡入处理
            if fadeInFrames > 0 {
                let fadeRatio = Double(fadeInFrames) / Double(2048)
                sampleValue = Int16(Double(sampleValue) * fadeRatio)
                fadeInFrames -= 1
            }
            
            for channel in 0..<channels {
                bufferData[frameIndex * channels + channel] = sampleValue
            }
            
            currentOffset += 1
        }
        
        offset = currentOffset
        buffer.pointee.mAudioDataByteSize = UInt32(totalBytes)
        
        let enqueueResult = AudioQueueEnqueueBuffer(audioQueue, buffer, 0, nil)
        if enqueueResult != 0 {
            print("Enqueue error: \(enqueueResult)")
        }
    }
}

三、验证与额外建议 #

• 测试缓冲区数量：现在设置3个缓冲区（你原来的默认值）就应该能持续播放了，不需要大量缓冲区。
• 检查音频格式：你的AudioStreamBasicDescription设置是正确的，kAudioFormatFlagIsSignedInteger | kAudioFormatFlagIsPacked适合iOS的线性PCM输出。
• 运行循环：确保AudioQueue的回调在正确的运行循环中执行，你提到已经验证过回调被调用，现在调整缓冲区大小后应该能正常复用。

这些修改应该能解决你遇到的初始咔哒声、复用缓冲区无声音以及卡顿/中断的问题。

内容的提问来源于stack exchange，提问作者Ash