使用AVAudioUnitTimePitch播放AVAudioPlayerNode出现爆音问题求助

爆音原因确认 #

是的，AVAudioUnitTimePitch确实是爆音的根源。根据官方文档，这个单元是为离线音频处理设计的，它的算法在处理实时音频流时，无法保证音频帧的连续过渡——尤其是在暂停/播放、实时调整音高参数时，会产生波形断层，直接表现为爆音。移除该节点后爆音消失，也验证了这一点。

实时音高/速率调整的解决方案 #

要实现无爆音的实时音高/速率控制，推荐使用AVAudioUnitVarispeed，这是Apple专门为实时音频场景优化的单元，支持平滑的参数调整和音频流连续处理。结合平滑的音量淡入淡出逻辑，可以彻底解决爆音问题。

修改后的代码示例 #

@Observable
class AudioEngineManager {
    private var engine = AVAudioEngine()
    private var playerNode = AVAudioPlayerNode()
    private var reverb = AVAudioUnitReverb()
    // 替换TimePitch为Varispeed
    private var varispeed = AVAudioUnitVarispeed()
    
    private var audioFile: AVAudioFile?
    // 记录当前音量，用于淡入淡出
    private var currentVolume: Float = 1.0
    private let fadeDuration: TimeInterval = 0.15 // 淡入淡出时长，可调整
    
    init() {
        setupAudioEngine()
    }
    
    private func setupAudioEngine() {
        guard let url = Bundle.main.url(forResource: "Song", withExtension: "mp3") else {
            print("Audio file not found")
            return
        }
        
        do {
            audioFile = try AVAudioFile(forReading: url)
        } catch {
            print("Failed to load audio file: \(error)")
            return
        }
        
        reverb.loadFactoryPreset(.mediumHall)
        reverb.wetDryMix = 50
        
        // 初始设置：保持速率不变，升高1半音（100 cents）
        varispeed.rate = 1.0
        varispeed.pitch = 100
        
        engine.attach(playerNode)
        engine.attach(varispeed)
        engine.attach(reverb)
        
        // 正确连接节点链：player -> varispeed -> reverb -> 主混音器
        guard let format = audioFile?.processingFormat else { return }
        engine.connect(playerNode, to: varispeed, format: format)
        engine.connect(varispeed, to: reverb, format: format)
        engine.connect(reverb, to: engine.mainMixerNode, format: format)
    }
    
    func prepare() {
        guard let audioFile else { return }
        playerNode.scheduleFile(audioFile, at: nil)
    }
    
    func play() {
        guard !playerNode.isPlaying else { return }
        
        do {
            try engine.start()
        } catch {
            print("Failed to start engine: \(error)")
            return
        }
        
        playerNode.play()
        // 音量淡入
        let startTime = AVAudioTime.now()
        playerNode.scheduleParameterBlock { [weak self] time, eventList in
            guard let self = self, let time = time else { return }
            let elapsed = time.timeIntervalSince(startTime)
            if elapsed < self.fadeDuration {
                self.currentVolume = Float(elapsed / self.fadeDuration)
                self.playerNode.setVolume(self.currentVolume, at: time)
            } else if self.currentVolume < 1.0 {
                self.currentVolume = 1.0
                self.playerNode.setVolume(self.currentVolume, at: time)
            }
        }
    }
    
    func pause() {
        guard playerNode.isPlaying else { return }
        
        let startTime = AVAudioTime.now()
        playerNode.scheduleParameterBlock { [weak self] time, eventList in
            guard let self = self, let time = time else { return }
            let elapsed = time.timeIntervalSince(startTime)
            if elapsed < self.fadeDuration {
                self.currentVolume = 1.0 - Float(elapsed / self.fadeDuration)
                self.playerNode.setVolume(self.currentVolume, at: time)
            } else {
                self.playerNode.pause()
                self.engine.pause()
                self.currentVolume = 0.0
            }
        }
    }
    
    func setPitch(_ value: Float) {
        // Varispeed支持实时调整pitch，无爆音
        varispeed.pitch = value
    }
    
    func setRate(_ value: Float) {
        // 同时调整速率（可选，rate>1加速且升调，rate<1减速且降调）
        varispeed.rate = value
    }
    
    func setReverbMix(_ value: Float) {
        reverb.wetDryMix = value
    }
}

关键优化点说明 #

1. 替换为AVAudioUnitVarispeed：该单元的算法专为实时音频流设计，参数调整和音频处理过程中能保持波形连续，从根源避免爆音。
2. 正确的节点连接：确保音频流依次经过播放器、Varispeed、混响，最后到主混音器，保证所有效果都正确作用于音频。
3. 平滑音量淡入淡出：在播放和暂停时，通过scheduleParameterBlock逐步调整播放器音量，避免突然的音量突变产生爆音，同时不影响效果单元的处理。
4. 实时参数调整：Varispeed的pitch和rate参数支持实时修改，调整过程中不会出现音频断层。

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