ARKit中为SCNNode附加程序化音频失败问题求助

已实现的功能 #

通过静态WAV文件生成音频并绑定到AR平面节点，播放正常：

let audioSource = SCNAudioSource(fileNamed: "chime.wav")
let audioPlayer = SCNAudioPlayer(source: audioSource)
node.addAudioPlayer(audioPlayer)

遇到的问题 #

使用AVAudioNode生成程序化音频，绑定到SCNAudioPlayer后添加到节点，无音频输出且无报错：

let audioNode = AVAudioSourceNode(format: format, renderBlock: { _, _, frameCount, audioBufferList -> OSStatus in 
 // 音频生成代码
 })
let audioPlayer = SCNAudioPlayer(avAudioNode: audioNode)
node.addAudioPlayer(audioPlayer)

• 单独将该AVAudioNode附加到AVAudioEngine实例时，音频生成正常
• 修复WWDC18的SwiftShot项目编译错误后，图形功能正常但音频仍无法工作
• 苹果文档提到的audioPlayerWithAVAudioNode:方法在Swift中无对应实现，当前使用的SCNAudioPlayer(avAudioNode:)是官方提供的初始化器

排查与解决思路 #

1. 确保音频会话配置正确 #

ARKit运行时可能会干扰音频会话状态，需提前配置并激活：

do {
    try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
    try AVAudioSession.sharedInstance().setActive(true)
} catch {
    print("音频会话配置失败：\(error)")
}

如果需要同时使用麦克风（比如AR场景的语音交互），可将类别设为.playAndRecord，并添加对应的Info.plist权限描述。

2. 防止SCNAudioPlayer被提前回收 #

局部变量创建的SCNAudioPlayer可能被ARC提前释放，需将其设为节点的属性：

class PlaneDetectionNode: SCNNode {
    var proceduralPlayer: SCNAudioPlayer?
    
    func setupProceduralAudio() {
        let audioFormat = AVAudioFormat(standardFormatWithSampleRate: 44100, channels: 2)!
        let sourceNode = AVAudioSourceNode(format: audioFormat) { _, _, frameCount, bufferList in
            // 示例：生成440Hz正弦波
            let buffers = UnsafeMutableAudioBufferListPointer(bufferList)
            for buffer in buffers {
                guard let dataPtr = buffer.mData?.assumingMemoryBound(to: Float.self) else { continue }
                for sampleIdx in 0..<Int(frameCount) {
                    dataPtr[sampleIdx] = sin(2 * .pi * 440 * Float(sampleIdx)/44100) * 0.1
                }
            }
            return noErr
        }
        
        self.proceduralPlayer = SCNAudioPlayer(avAudioNode: sourceNode)
        self.addAudioPlayer(proceduralPlayer!)
    }
}

3. 避免AVAudioEngine与SceneKit音频管线冲突 #

不要将同一个AVAudioNode同时绑定到AVAudioEngine和SCNAudioPlayer——节点只能属于一个音频处理管线。测试时若单独用了AVAudioEngine，需确保创建新的AVAudioNode用于SceneKit。

4. SwiftShot项目音频修复建议 #

旧项目的音频代码可能依赖过时的API，需：

• 替换旧的音频初始化逻辑为上述的会话配置+属性化SCNAudioPlayer写法
• 检查Info.plist是否添加了必要的音频权限描述（如NSAudioUsageDescription）
• 确保项目的部署目标适配当前Xcode版本，避免API兼容性问题

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