AudioKit 5.5音频效果链搭建时引擎启动崩溃问题求助

问题背景 #

我是AudioKit新手，正在开发一款支持音频效果链的应用，核心需求如下：

• 分离左右声道；
• 检测音频信号幅度是否超过阈值；
• 设置两个独立延迟效果（delay 1和delay 2）；
• 信号超阈值时使用equaliser 1均衡，否则使用equaliser 2；左右声道可根据延迟独立切换均衡器，处理后对应输出到原声道。

代码无语法错误，但在模拟器测试时应用崩溃，提示启动引擎未设置正确输出，崩溃发生在以下代码行：

engine.output = stereoOutputMixer

附上类初始化代码片段：

var audioFilePlayer: AudioPlayer?

class AudioProcessor: ObservableObject {
    var engine: AudioEngine
    var mic: AudioEngine.InputNode!
    var mixer: Mixer
    
    var equalizer1: Equalizer
    var equalizer2: Equalizer
    var amplitudeTap: AmplitudeTap?
    var threshold: Float = 40.0
    var equalizer1Mixer: Mixer
    var equalizer2Mixer: Mixer
    
    var leftPanner: Panner
    var rightPanner: Panner
    var leftPannerMixer: Mixer
    var rightPannerMixer: Mixer

    var stereoOutputMixer: Mixer
    var delay1: Delay
    var delay2: Delay
    var highPassFilter: HighPassFilter
    var lowPassFilter: LowPassFilter
    var leftVolumeMixer: Mixer
    var rightVolumeMixer: Mixer
    var micMixer: Mixer
    var fileMixer: Mixer
    var leftOutputPanner: Panner
    var rightOutputPanner: Panner

    var isAboveThreshold: Bool = false

    var preferences: UserPreferences

    init(preferences: UserPreferences = UserPreferences()) {
        // First, initialize all properties
        self.preferences = preferences
        self.engine = AudioEngine()
        self.mixer = Mixer()

        // Initialize equalizers with default frequencies
        let frequencies: [Double] = [125, 250, 500, 750, 1000, 1500, 2000, 3000, 4000, 6000, 8000]
        self.equalizer1 = Equalizer(engine: engine, input: mixer, frequencies: frequencies)
        self.equalizer2 = Equalizer(engine: engine, input: mixer, frequencies: frequencies)
        
        self.delay1 = Delay(equalizer1.output)
        self.delay1.time = preferences.delay1Time
        self.delay2 = Delay(equalizer2.output)
        self.delay2.time = preferences.delay2Time
        self.threshold = preferences.threshold  // Initialize threshold

        self.highPassFilter = HighPassFilter(mixer, cutoffFrequency: preferences.highPassFilterFrequency, resonance: 1)
        self.lowPassFilter = LowPassFilter(mixer, cutoffFrequency: preferences.lowPassFilterFrequency, resonance: 1)

        self.leftPanner = Panner(mixer, pan: -1)
        self.rightPanner = Panner(mixer, pan: 1)

        self.leftOutputPanner = Panner(equalizer1.output, pan: -1)
        self.rightOutputPanner = Panner(equalizer2.output, pan: 1)

        self.leftVolumeMixer = Mixer()
        self.rightVolumeMixer = Mixer()

        self.stereoOutputMixer = Mixer()

        self.micMixer = Mixer()
        self.fileMixer = Mixer()

        self.isAboveThreshold = false
        self.amplitudeTap = nil

        // Now that all properties are initialized, call methods to set up the audio chain
        // Initialize mixers for each equalizer
        equalizer1Mixer = Mixer()
        equalizer2Mixer = Mixer()

        // Initialize panners and their mixers
        leftPannerMixer = Mixer()
        rightPannerMixer = Mixer()
        
        setupDelays()
        setupFilters()
        setupPanners()
        setupVolumeControlMixers()
        setupMicAndFileMixers()
        applyEqualizerGains(preferences: preferences)
        setVolumeBalance(leftVolume: preferences.balanceVolumeLeft, rightVolume: preferences.balanceVolumeRight)
        setMicPlaybackBalance(micVolume: preferences.micGain, playbackVolume: preferences.playbackVolume)

        if preferences.micEnabled {
            setupMicrophone()
        }
        startEngine()
        setupInitialAudioChain()
        
        setupAmplitudeMonitoring()
        checkAmplitudeAndApplyDelays()
        applyDelaysAndSwitchEqualizers()
        engine.output = stereoOutputMixer
    }
}

崩溃原因分析 #

1. 引擎启动时机错误：在设置完整音频链路前就调用startEngine()，此时stereoOutputMixer无任何输入源，AudioKit引擎无法识别有效输出路径，触发崩溃。
2. 输出混音器无有效输入：stereoOutputMixer初始化后未连接任何上游音频节点（如延迟、均衡器输出），属于空混音器，无法产生有效音频信号。
3. 音频链路连接断裂：部分混音器（如equalizer1Mixer、leftPannerMixer）初始化后未整合到信号流中，导致路径不完整。

修复方案 #

1. 调整引擎启动顺序 #

将startEngine()移到完整音频链路设置完成并指定引擎输出之后，确保引擎启动时已有有效输出路径：

// 移除原位置的startEngine()调用
// startEngine()

setupInitialAudioChain()
setupAmplitudeMonitoring()
checkAmplitudeAndApplyDelays()
applyDelaysAndSwitchEqualizers()

// 先设置输出，再启动引擎
engine.output = stereoOutputMixer
startEngine()

2. 为stereoOutputMixer添加输入源 #

在setupInitialAudioChain()方法中，将处理后的音频信号接入输出混音器，示例逻辑如下：

func setupInitialAudioChain() {
    // 根据你的效果链逻辑，接入左右声道的最终处理输出
    stereoOutputMixer.addInput(leftOutputPanner.output)
    stereoOutputMixer.addInput(rightOutputPanner.output)
    // 若需要延迟后的信号，可替换为delay1/delay2的输出
}

3. 梳理完整音频链路 #

确保所有节点形成连续信号流：
输入源（麦克风/音频文件）→ 混音器 → 滤波器 → 声道分离 → 幅度检测 → 均衡器切换 → 延迟 → 音量控制 → 输出混音器 → 引擎输出
检查setupDelays()、setupPanners()等方法，确认每个节点的输出都正确接入下一个节点，最终汇总到stereoOutputMixer。

4. 空混音器 fallback 处理 #

若暂时无有效输入，可给stereoOutputMixer添加静音节点作为 fallback，避免引擎启动出错：

// 在stereoOutputMixer初始化后添加
let silence = Silence()
stereoOutputMixer.addInput(silence.output)

5. 麦克风权限检查 #

启用麦克风时，必须确保已获取音频输入权限，否则会导致引擎启动失败，在setupMicrophone()中添加检查逻辑：

func setupMicrophone() {
    switch AVAudioSession.sharedInstance().recordPermission {
    case .granted:
        mic = engine.inputNode
        micMixer.addInput(mic.output)
        // 后续连接逻辑
    case .denied, .undetermined:
        AVAudioSession.sharedInstance().requestRecordPermission { granted in
            if granted {
                DispatchQueue.main.async {
                    self.setupMicrophone()
                }
            }
        }
    @unknown default:
        break
    }
}

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