使用CallKit的VOIP应用闹钟中断后激活音频会话失败求助

我之前在开发VOIP+CallKit的项目时，刚好碰到过几乎一模一样的问题！当时排查了好久才找到根源，分享下我的解决思路和方案：

首先先明确这个错误码的含义：1701737535对应的FourCC是ent?，本质是当前系统中有优先级更高的音频会话仍在占用资源，或者你的音频会话配置与当前系统音频环境冲突——而CallKit的存在会让音频会话的管理逻辑变得更复杂，因为它会接管部分会话的生命周期，这也是不用CallKit时没问题的原因。

下面是具体的排查和解决步骤：

1. 严格遵循CallKit的音频会话回调流程 #

这是最关键的一点！很多人会错误地在AVAudioSessionInterruptionNotification的中断结束回调里直接激活会话，但CallKit的音频会话管理有自己的节奏：

• 当闹钟触发音频中断时，系统会先调用CXProviderDelegate的provider:didDeactivateAudioSession:，此时你需要立刻暂停音频流、清理音频单元、确保AVAudioSession处于非活跃状态。
• 当闹钟停止、中断结束后，系统会主动回调provider:didActivateAudioSession:，这才是你重新初始化音频单元、激活会话的正确时机！
• 错误做法：在AVAudioSessionInterruptionTypeEnded通知里直接调用setActive:YES——此时CallKit还没完成音频会话的重新绑定，系统会认为你的会话请求非法，返回ent?错误。

2. 检查音频会话的配置参数 #

确保你的音频会话配置和CallKit兼容：

• 必须使用AVAudioSessionCategoryPlayAndRecord作为会话类别，这是VOIP应用的标准配置。
• 类别选项建议包含AVAudioSessionCategoryOptionMixWithOthers，这样可以避免和系统音频（比如闹钟）的冲突，中断后也能顺利重新激活。
• 不要手动修改会话的mode，CallKit会自动将其设置为AVAudioSessionModeVoiceChat，手动修改会导致会话状态混乱。

示例配置（在CallKit激活前设置）：

let session = AVAudioSession.sharedInstance()
do {
    try session.setCategory(.playAndRecord, options: [.mixWithOthers, .allowBluetooth, .defaultToSpeaker])
} catch {
    print("Failed to set audio session category: \(error)")
}

3. 强制清理残留的会话状态（可选） #

如果按照上面的流程还是出现错误，可以在provider:didActivateAudioSession:回调里，先尝试强制停用可能残留的活跃会话，再重新激活：

func provider(_ provider: CXProvider, didActivate audioSession: AVAudioSession) {
    // 先强制停用旧会话
    do {
        try audioSession.setActive(false, options: .notifyOthersOnDeactivation)
    } catch {
        print("Failed to deactivate old session: \(error)")
    }
    // 再激活并初始化音频单元
    do {
        try audioSession.setActive(true)
        // 这里初始化你的音频单元
        setupAudioUnit()
    } catch {
        print("Failed to activate session: \(error)")
    }
}

4. 调整音频单元的初始化时机 #

不要在应用启动时就初始化音频单元，而是在provider:didActivateAudioSession:里初始化，中断结束后也在这里重新初始化。因为音频单元是绑定到当前活跃的音频会话的，中断后旧的会话已经失效，必须重新绑定新的会话才能正常工作。

总结 #

核心问题就是CallKit和AVAudioSession的生命周期没有对齐——中断结束后，一定要等待CallKit的didActivateAudioSession:回调，再去处理音频会话激活和音频单元初始化，而不是自己手动触发。按照这个流程调整后，我当时的问题就完全解决了。

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