Audio Unit扩展App替换文件播放为engine.inputNode输入报错排查

错误根源 #

报错required condition is false: _engine != nil说明在startPlaying()执行时，AVAudioEngine实例已变为nil，核心原因是：

1. 修改后的连接逻辑依赖file?.processingFormat，但改用麦克风输入后，原音频文件不再被使用，导致连接代码完全未执行，引擎节点连接状态异常
2. 连接节点时传入nil作为格式，触发AVAudioEngine内部状态错误
3. 未配置麦克风权限，导致引擎启动失败后被释放

具体修复步骤 #

1. 修正节点连接逻辑（移除对音频文件的依赖） #

替换SimplePlayEngine的connect()方法代码：

if avAudioUnit.wantsAudioInput {
    // 先断开所有旧连接，避免残留
    engine.disconnectNodeInput(avAudioUnit)
    engine.disconnectNodeInput(engine.mainMixerNode)
    
    // 安全移除player节点（如果已附加到引擎）
    if engine.isAttached(player) {
        engine.detach(player)
    }
    
    // 使用麦克风输入节点的标准格式连接，避免传nil
    let inputFormat = engine.inputNode.outputFormat(forBus: 0)
    engine.connect(engine.inputNode, to: avAudioUnit, format: inputFormat)
    engine.connect(avAudioUnit, to: engine.mainMixerNode, format: inputFormat)
}

2. 添加麦克风权限配置 #

在项目的Info.plist中添加键值对：

• 键：NSMicrophoneUsageDescription
• 值：填写麦克风使用说明（例如："需要访问麦克风进行实时音频处理"）

iOS要求必须声明权限，否则麦克风输入会被系统拒绝，间接导致引擎启动失败。

3. 强化引擎状态检查 #

修改startPlaying()方法，提前检查引擎有效性：

func startPlaying() throws {
    try stateChangeQueue.sync {
        guard let validEngine = engine else {
            throw NSError(domain: "SimplePlayEngine", code: -1, userInfo: [NSLocalizedDescriptionKey: "音频引擎未正确初始化"])
        }
        // 原启动逻辑保持不变，替换所有engine为validEngine
        try validEngine.start()
        // ... 其他原有代码
    }
}

4. 确保引擎实例被强引用 #

检查SimplePlayEngine的初始化代码，保证engine被强持有：

class SimplePlayEngine {
    private let engine: AVAudioEngine
    private let avAudioUnit: AVAudioUnit
    // ... 其他属性
    
    init(avAudioUnit: AVAudioUnit) {
        self.engine = AVAudioEngine()
        self.avAudioUnit = avAudioUnit
        // 原有初始化逻辑
    }
}

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