iOS中AVAudioEngine仅首次播放声音问题求助

DevOps 小满

2026-5-25

嘿，这个问题我之前用AVAudioEngine做循环音效的时候也踩过坑！核心问题大概率是你在Stop操作后没有正确重置播放节点的状态，或者循环播放的逻辑在第二次启动时没有重新触发。我给你梳理下解决方案，附代码示例：

问题根源分析

首次播放正常是因为节点都是新鲜初始化的，音频文件的读取器也从开头开始；但点击Stop后，playerNode可能处于停止状态但之前的播放任务已经完成，音频文件的读取指针到了末尾，第二次点击Play时没有重新调度新的读取任务，导致没声音。另外，如果Stop时错误地断开了节点连接或者销毁了引擎，也会导致后续无法播放。

正确的实现步骤

1. 初始化音频组件（只做一次）

先把引擎、播放节点、音调单元这些组件初始化好，并且保持引用，不要每次播放都重新创建：

// 作为ViewController的属性
private var audioEngine: AVAudioEngine!
private var playerNode: AVAudioPlayerNode!
private var timePitchUnit: AVAudioUnitTimePitch!
private var audioFile: AVAudioFile?

override func viewDidLoad() {
    super.viewDidLoad()
    setupAudioComponents()
}

private func setupAudioComponents() {
    audioEngine = AVAudioEngine()
    playerNode = AVAudioPlayerNode()
    timePitchUnit = AVAudioUnitTimePitch()
    
    // 设置你需要的音调，比如+1200是升一个八度，负数是降调
    timePitchUnit.pitch = 800
    
    // 把节点附加到引擎，并连接链路
    audioEngine.attach(playerNode)
    audioEngine.attach(timePitchUnit)
    
    audioEngine.connect(playerNode, to: timePitchUnit, format: nil)
    audioEngine.connect(timePitchUnit, to: audioEngine.mainMixerNode, format: nil)
    
    // 加载你的蜂鸣音效文件
    guard let soundURL = Bundle.main.url(forResource: "beep", withExtension: "wav") else {
        print("找不到音效文件！")
        return
    }
    do {
        audioFile = try AVAudioFile(forReading: soundURL)
    } catch {
        print("加载音效失败：\(error.localizedDescription)")
    }
}

2. Play按钮的正确逻辑

每次点击Play时，先停止之前的播放（防止重复叠加），确保引擎在运行状态，然后重新调度音频文件的播放，并通过完成回调实现循环：

@IBAction func playTapped(_ sender: UIButton) {
    guard let audioFile = audioFile else { return }
    
    // 先停止当前播放，重置节点状态
    playerNode.stop()
    
    // 如果引擎没在运行，启动它
    if !audioEngine.isRunning {
        do {
            try audioEngine.start()
        } catch {
            print("启动音频引擎失败：\(error.localizedDescription)")
            return
        }
    }
    
    // 调度音频文件播放，完成后递归调用实现循环
    playerNode.scheduleFile(audioFile, at: nil) { [weak self] in
        self?.scheduleNextPlay()
    }
    
    playerNode.play()
}

private func scheduleNextPlay() {
    guard let audioFile = audioFile else { return }
    playerNode.scheduleFile(audioFile, at: nil, completionHandler: scheduleNextPlay)
}

3. Stop按钮的正确逻辑

Stop时只需要停止播放节点，暂停引擎即可，不要销毁或断开节点，这样下次Play可以直接复用：

@IBAction func stopTapped(_ sender: UIButton) {
    playerNode.stop()
    audioEngine.pause()
}

关键注意点

不要在Stop时销毁playerNode、audioEngine这些组件，否则下次播放需要重新初始化和连接，容易出错
每次Play前必须调用playerNode.stop()，确保之前的播放任务被终止，避免音频叠加或者状态混乱
循环播放通过completionHandler递归调度，而不是依赖重复播放的参数（AVAudioPlayer有numberOfLoops，但AVAudioPlayerNode需要手动处理循环）
如果需要动态改变音调，直接修改timePitchUnit.pitch的值即可，不需要重启引擎或节点

这样调整后，你点击Stop再Play应该就能正常播放了。

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