macOS+Swift下AVAudioEngine与PlayerNode无声音输出及报错排查

报错解析 #

• AddInstanceForFactory: No factory registered for id <CFUUID...>：属于CoreAudio HAL层的插件注册警告，通常和音频设备驱动加载异常或沙箱权限不足相关。
• HALC_ShellDriverPlugIn::Open: opening the plug-in failed, Error: 2003329396：错误码对应kAudioHardwareUnspecifiedError，本质是音频硬件驱动加载失败，核心原因是权限缺失。
• HALC_ProxyIOContext::IOWorkLoop: skipping cycle due to overload：音频IO循环过载，因为引擎未正确初始化、无输出权限导致无法正常驱动音频流，进而触发过载报错。

缺失步骤与修复方案 #

1. 补充沙箱音频输出权限 #

当前仅勾选了音频输入权限，但播放音频需要Audio Output权限。在Xcode项目设置的Signing & Capabilities -> App Sandbox中，勾选Audio Output选项。

2. 正确初始化AVAudioSession #

音频引擎启动前必须正确配置并激活音频会话，确保系统授权。将原代码中的音频初始化逻辑拆分，先处理会话：

let session = AVAudioSession.sharedInstance()
do {
    try session.setCategory(.playback, mode: .default)
    try session.activate()
    setupAudioEngine() // 拆分出音频引擎初始化方法
} catch {
    print("会话配置失败：\(error)")
}

3. 修复核心播放逻辑 #

原代码创建了音频buffer，但未将其调度给AVAudioPlayerNode，这是无声音的直接原因。在player.play()前添加：

player.scheduleBuffer(buffer, at: nil, completionHandler: nil)

如果需要循环播放，可将参数改为options: .loops。

4. 优化错误处理 #

原代码用try? engine.start()吞掉了错误信息，改为显式捕获便于排查：

do {
    try engine.start()
} catch {
    print("引擎启动失败：\(error)")
    return
}

5. 移除多余初始化代码 #

刚创建AVAudioEngine后调用engine.reset()属于无效操作，直接删除即可。

完整修复代码 #

import Foundation
import AVFoundation

class ViewController: NSViewController {
    
    public var engine: AVAudioEngine!
    public var player : AVAudioPlayerNode!

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 先配置音频会话
        let session = AVAudioSession.sharedInstance()
        do {
            try session.setCategory(.playback, mode: .default)
            try session.activate()
            setupAudioEngine()
        } catch {
            print("会话配置失败：\(error)")
        }
    }
    
    private func setupAudioEngine() {
        engine = AVAudioEngine()
        player = AVAudioPlayerNode()
        
        guard let path = Bundle.main.path(forResource: "song", ofType: "mp3") else {
            print("无法获取音频文件路径")
            return
        }
        print("\(path)")
        let url: URL = URL(fileURLWithPath: path)

        guard let file = try? AVAudioFile(forReading: url) else {
            print("读取音频文件失败")
            return
        }

        let format = file.processingFormat
        let framecount = AVAudioFrameCount(file.length)
        guard let buffer = AVAudioPCMBuffer(pcmFormat: format, frameCapacity: framecount) else{
            print("创建PCM缓冲失败")
            return
        }
        do{
            try file.read(into: buffer)
        } catch{
            print("读取文件到缓冲失败：\(error)")
            return
        }
        
        let mainMixer = engine.mainMixerNode
        engine.attach(player)
        engine.connect(player, to: mainMixer, format: buffer.format)
        engine.prepare()
        
        do {
            try engine.start()
        } catch {
            print("引擎启动失败：\(error)")
            return
        }
        
        // 调度音频缓冲到播放器
        player.scheduleBuffer(buffer, at: nil, completionHandler: nil)
        player.play()
    }
}

额外提示 #

• 后续处理USB音频输入时，需将音频会话类别改为.playAndRecord，并主动请求输入权限。
• Sonoma系统下首次运行时，注意不要忽略系统弹出的音频权限授权弹窗。

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