SpriteKit搭配AVAudioPlayerNode使用缓冲音频时positional audio失效问题

• 核心故障点：手动将AVAudioPlayerNode直接连接到audioEngine的mainMixerNode，跳过了SpriteKit内部实现位置音频所需的3D混音处理链路。SKAudioNode的isPositional属性生效依赖SpriteKit自动管理的音频节点连接逻辑，手动连接会直接让位置属性失效。
• 配置时序错误：isPositional属性需要在给SKAudioNode赋值avAudioNode之前开启，晚于赋值的配置不会生效。
• 缺少听者配置：未显式设置SKScene的audioListener属性，SpriteKit无法确定以哪个节点的位置作为音频接收方的坐标，位置计算逻辑无法生效。
• 冗余配置：isUserInteractionEnabled属性仅控制节点的触摸等交互响应，和音频功能无关，无需额外设置。
• 额外注意：SpriteKit位置音频仅支持单声道音频源，若使用立体声资源会直接失效，需提前将音频文件转成单声道格式。

import SpriteKit
import AVFoundation

class GameScene: SKScene {
    let audioFilePlayer = AVAudioPlayerNode()

    override func didMove(to view: SKView) {
        let player = SKSpriteNode(imageNamed: "player")
        player.position = CGPoint(x: 0, y: 0)
        addChild(player)
        // 显式设置音频听者节点
        audioListener = player
        
        let sprite = SKSpriteNode(imageNamed: audioSourceImage)
        sprite.position = CGPoint(x: 10, y: 0)
        player.addChild(sprite)
        
        // 初始化SKAudioNode后立刻开启位置音频配置
        let backgroundMusic = SKAudioNode()
        backgroundMusic.isPositional = true
        sprite.addChild(backgroundMusic)
        
        let url = Bundle.main.url(forResource: "audioSourceMono", withExtension: "m4a")!
        let file = try! AVAudioFile(forReading: url)
        do {
            let audioFormat = file.processingFormat
            let audioFrameCount = UInt32(file.length)
            guard let audioFileBuffer = AVAudioPCMBuffer(pcmFormat: audioFormat, frameCapacity: audioFrameCount) else { return }
            try file.read(into: audioFileBuffer)
            
            audioEngine.attach(audioFilePlayer)
            // 直接给SKAudioNode赋值avAudioNode，由SpriteKit管理连接链路
            backgroundMusic.avAudioNode = audioFilePlayer
            
            try audioEngine.start()
            // 如需循环播放可保留.loops参数，不需要直接移除即可
            audioFilePlayer.scheduleBuffer(audioFileBuffer, at: nil, options: .loops, completionHandler: nil)
            audioFilePlayer.play()
        } catch {
            print(error)
        }
    }
}

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