如何在Swift中正确使用CoreAudio Render Callbacks？

嘿，我太懂你这种挫败感了——跟着教程把C代码转成Swift，满心期待纯净的音调，结果出来的却是闹心的白噪音，换谁都得挠头！我之前用CoreAudio的时候也踩过类似的坑，给你捋几个最容易出问题的地方，你对着检查下：

• 先确认音频格式完全匹配
  这是最常见的锅！教程里的C代码用的音频格式（采样率、位深、通道数），你在Swift里设置的AudioStreamBasicDescription必须丝毫不差。比如教程用的是44100Hz采样率、16位单声道PCM，你要是不小心把位深设成32位浮点，或者采样率改成了48000，那生成的样本数据就会被错误解析，直接变成噪音。一定要核对mSampleRate、mBitsPerChannel、mChannelsPerFrame这些参数，一个都不能错。

• 样本生成的状态要保住
  生成正弦波这种连续音调，相位变量是要持续累加的。要是你把相位变量放在回调函数里每次都重置，那每次回调生成的都是随机的片段，拼起来就是白噪音。正确的做法是把相位（比如phase: Float）放在类的属性里，或者用闭包的捕获列表把它留住，确保每次回调都能在上一次的基础上继续计算相位。另外，样本值的范围也别搞混：16位PCM是-32768到32767，浮点PCM是-1.0到1.0，转换的时候一定要对应上。

• Swift和C回调的类型适配要到位
  CoreAudio的回调是C风格的，在Swift里写的时候很容易在类型转换上翻车。比如inNumberFrames是UInt32，循环的时候得转成Int，不然容易出越界问题；还有ioData是UnsafeMutablePointer<AudioBufferList>?，解包后获取样本指针时，一定要转换成和你设置的格式对应的类型（比如UnsafeMutablePointer<Int16>或者Float），要是类型不匹配，写入的数据就是乱的。

• 别忘了正确配置音频会话
  尤其是在iOS上，要是没激活音频会话或者类别设错了，也可能导致输出异常。记得调用AVAudioSession.sharedInstance().setActive(true)，并且把类别设成.playback，确保音频能正常输出。

给你贴个简化版的正确示例片段，你可以参考下：

class ToneGenerator {
    private var phase: Float = 0.0
    private let sampleRate: Float = 44100.0
    private let targetFrequency: Float = 440.0 // 标准A音
    
    func setupAudioQueue() {
        var format = AudioStreamBasicDescription()
        format.mSampleRate = sampleRate
        format.mFormatID = kAudioFormatLinearPCM
        format.mFormatFlags = kAudioFormatFlagIsSignedInteger | kAudioFormatFlagIsPacked
        format.mBitsPerChannel = 16
        format.mChannelsPerFrame = 1
        format.mBytesPerPacket = 2
        format.mBytesPerFrame = 2
        format.mFramesPerPacket = 1
        format.mReserved = 0
        
        var queue: AudioQueueRef?
        let callback: AudioQueueOutputCallback = { userData, queue, buffer in
            guard let userData = userData else { return }
            let generator = Unmanaged<ToneGenerator>.fromOpaque(userData).takeUnretainedValue()
            
            let bufferData = buffer.pointee.mAudioData!.assumingMemoryBound(to: Int16.self)
            let frameCount = Int(buffer.pointee.mAudioDataByteSize) / MemoryLayout<Int16>.size
            
            for i in 0..<frameCount {
                let sineValue = sin(generator.phase) * 32767.0
                bufferData[i] = Int16(clamping: sineValue)
                generator.phase += 2 * .pi * generator.targetFrequency / generator.sampleRate
                if generator.phase > 2 * .pi {
                    generator.phase -= 2 * .pi
                }
            }
            
            AudioQueueEnqueueBuffer(queue, buffer, 0, nil)
        }
        
        let userDataPtr = Unmanaged.passUnretained(self).toOpaque()
        AudioQueueNewOutput(&format, callback, userDataPtr, nil, nil, 0, &queue)
        
        // 初始化并启动队列
        var buffer: AudioQueueBufferRef?
        let bufferSize = Int(sampleRate * 0.1) * 2 // 100ms的缓冲
        AudioQueueAllocateBuffer(queue!, UInt32(bufferSize), &buffer)
        AudioQueueEnqueueBuffer(queue!, buffer!, 0, nil)
        AudioQueueStart(queue!, nil)
    }
}

你可以对照这些点排查你的代码，大概率是格式不匹配或者相位状态没保住的问题，调整后应该就能听到正常的音调啦！

备注：内容来源于stack exchange，提问作者Ash