使用AudioKit 5播放音频问题：无法启动播放

核心问题排查与修复 #

你的代码无报错但没有声音，主要有几个关键原因，按优先级排查：

1. 对象内存管理问题 #

你在方法内部创建的engine、audioPlayer都是局部变量，方法执行完毕后会被系统回收，导致音频引擎和播放器被销毁，自然没有声音。必须把这些对象声明为类的属性来持有：

class AudioPlayerViewController: UIViewController {
    // 作为类属性持有，避免被释放
    private let engine = AudioEngine()
    private let audioPlayer = AudioPlayer()
    private let pitchShifter = TimePitch()

    // ... 其他业务代码
}

2. 音频会话配置缺失 #

iOS需要明确配置音频会话类别，否则可能被系统静音（比如手机处于静音模式）或无权限播放。在启动引擎前添加会话配置：

do {
    // 配置音频会话为播放模式，允许后台播放（可选）
    try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
    try AVAudioSession.sharedInstance().setActive(true)
    
    try engine.start()
    // ... 加载音频文件逻辑
} catch {
    print("音频初始化失败: \(error.localizedDescription)")
}

3. 音频节点连接错误 #

你创建了pitchShifter但未将其接入音频链路，如果需要使用变调功能，应该把链路修正为：audioPlayer → pitchShifter → engine.output，否则pitchShifter不会生效，修正代码如下：

// 修正音频链路连接
engine.output = pitchShifter
pitchShifter.input = audioPlayer

4. 音频文件URL有效性验证 #

确保你传入的url是有效的本地文件URL，可在加载前添加验证：

guard FileManager.default.fileExists(atPath: url.path) else {
    print("音频文件不存在: \(url)")
    return
}

关于AudioKit.start()的说明 #

AudioKit 5确实移除了全局的AudioKit.start()方法，改用AudioEngine实例的start()方法，你的调用方式是正确的。官方Playground教程可能未完全同步5.x的API变化，属于文档滞后问题。

极简可运行入门示例 #

下面是一个完整的极简示例，确保能正常播放音频：

import UIKit
import AudioKit

class AudioDemoViewController: UIViewController {
    private let engine = AudioEngine()
    private let audioPlayer = AudioPlayer()
    
    override func viewDidLoad() {
        super.viewDidLoad()
        setupAudio()
    }
    
    private func setupAudio() {
        // 连接播放器到引擎输出
        engine.output = audioPlayer
        
        do {
            // 配置音频会话
            try AVAudioSession.sharedInstance().setCategory(.playback, mode: .default)
            try AVAudioSession.sharedInstance().setActive(true)
            
            // 启动引擎
            try engine.start()
            
            // 加载本地音频文件（替换成你的文件URL）
            guard let url = Bundle.main.url(forResource: "test", withExtension: "mp3") else {
                print("找不到音频文件")
                return
            }
            let audioFile = try AVAudioFile(forReading: url)
            try audioPlayer.load(file: audioFile, buffered: true)
            
            // 开始播放
            audioPlayer.play()
        } catch {
            print("音频错误: \(error.localizedDescription)")
        }
    }
}

额外注意事项 #

• 确保项目已正确集成AudioKit 5（通过CocoaPods或Swift Package Manager）
• 测试时关闭手机静音模式，或在会话配置中添加options: .mixWithOthers允许静音下播放
• 如果需要后台播放，需在项目Info.plist中添加UIBackgroundModes并勾选audio

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