AudioKit动态切换输入输出设备的最佳实践技术问询

我在开发支持自定义音频设备选择的应用时踩过不少类似的坑，下面是经过实际项目验证的最佳操作流程，应该能帮你解决切换后出现的错误问题：

严格遵循的切换流程 #

切换前的停止操作（重中之重） #

• 先停止你的AKMicrophone实例：调用mic.stop()，确保输入节点不再捕获音频；
• 停止整个AudioKit引擎：调用AudioKit.stop()；
• 等待引擎完全停止后再进行下一步——可以通过监听AudioKit.engine.isRunning状态，或者用异步延迟（比如0.1秒，根据实际情况调整）来避免操作过于仓促，这一步能避免绝大多数资源冲突问题。

执行设备切换 #

• 输入设备切换：
  • 如果是针对特定AKMicrophone实例设置设备，直接调用mic.setDevice(目标设备)；
  • 如果要全局设置AudioKit的输入设备，调用AudioKit.setInputDevice(目标设备)；
• 输出设备切换：调用AudioKit.setOutputDevice(目标设备)；
  注：同时切换输入和输出的话，顺序没有严格要求，但必须都在引擎停止状态下执行。

切换后的重启操作 #

• 先重启AKMicrophone：调用mic.start()；
• 再启动AudioKit引擎：建议用do-catch包裹来捕获错误，示例代码如下：

  do {
      try AudioKit.start()
  } catch {
      print("AudioKit启动失败: \(error.localizedDescription)")
      // 这里可以给用户弹出提示，比如设备不可用或权限不足
  }
  

• 启动后检查AudioKit.engine.isRunning状态，确认引擎正常运行后再恢复音频功能。

为什么必须调用stop/start？ #

• AudioKit底层依赖AVAudioEngine，引擎运行时直接修改设备会导致音频流中断、资源锁死，这就是你操作后出现大量错误的核心原因；
• AKMicrophone的设备绑定是在启动时完成的，不停止就切换设备会导致节点与新设备不兼容，后续无法正常捕获音频；
• 跳过停止步骤直接切换，会触发AVAudioEngine的错误回调，甚至让引擎进入不可恢复的故障状态，后续再启动也无法正常工作。

额外避坑提示 #

• 操作时机：用户选择设备后，先显示加载状态（比如ActivityIndicator），再执行切换流程，防止用户重复触发操作；
• 系统设备变化监听：如果用户插拔耳机、连接蓝牙音箱等导致系统音频设备变化，要在AVAudioSession的routeChangeNotification回调中重新执行上述切换流程，避免音频功能失效；
• 资源清理：如果切换后不再使用旧的AKMicrophone实例，记得将其置为nil，避免内存泄漏和资源占用。

内容的提问来源于stack exchange，提问作者E.R.