锁屏接听CallKit+WebRTC来电无声音问题求解决方案

阿华AIGC实验室

2026-5-13

解决锁屏接听CallKit+WebRTC无声音的问题

我之前也碰到过一模一样的情况——锁屏接起CallKit来电后完全没声音，切到前台才恢复。核心问题大多出在音频会话的同步时机和WebRTC对系统音频会话的接管逻辑上，结合你的代码，给你几个可行的调整方案：

1. 修正AVAudioSession的配置选项

你当前的configureAudioSession里用了.mixWithOthers，这个选项会让你的音频和其他App的音频混合播放，但锁屏下的通话场景需要独占音频资源，这个选项会干扰WebRTC的音频激活逻辑。建议修改配置：

func configureAudioSession() {
    let sharedSession = AVAudioSession.sharedInstance()
    do {
        // 移除.mixWithOthers，换成适合通话的选项组合
        try sharedSession.setCategory(
            AVAudioSessionCategoryPlayAndRecord,
            mode: AVAudioSessionModeVideoChat,
            options: [.allowBluetooth, .allowBluetoothA2DP, .defaultToSpeaker]
        )
    } catch {
        debugPrint("Failed to configure `AVAudioSession`: \(error.localizedDescription)")
    }
}

另外，不要在handleIncomingCall里提前调用configureAudioSession，把这个调用移到didActivate回调里——因为CallKit会在用户接听后自动激活音频会话，提前配置可能会和CallKit的音频管理冲突。

2. 确保WebRTC完全接管CallKit传入的音频会话

你的didActivate回调里已经调用了audioSessionDidActivate，但可以再加一步：强制让WebRTC的音频会话重新初始化，确保它正确绑定到系统激活的会话上：

func provider(_ provider: CXProvider, didActivate audioSession: AVAudioSession) {
    print("CallManager didActivate")
    // 先重置WebRTC的音频会话状态，避免旧状态干扰
    RTCAudioSession.sharedInstance().audioSessionDidDeactivate(nil)
    // 接管CallKit的音频会话
    RTCAudioSession.sharedInstance().audioSessionDidActivate(audioSession)
    // 延迟一小段时间再启用音频，避免锁屏下系统资源竞争
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
        RTCAudioSession.sharedInstance().isAudioEnabled = true
    }
    self.callDelegate?.callIsAnswered()
}

延迟启用音频是因为锁屏状态下系统资源加载较慢，立即启用可能会导致WebRTC还没完成会话绑定。

3. 添加音频会话中断/路由变化的监听

锁屏状态下音频会话容易被系统中断（比如锁屏时的其他音频事件），你需要监听这些通知并同步给WebRTC：

// 在初始化方法里添加监听
func setupAudioSessionNotifications() {
    NotificationCenter.default.addObserver(
        self,
        selector: #selector(handleAudioSessionInterruption(_:)),
        name: AVAudioSession.interruptionNotification,
        object: nil
    )
    NotificationCenter.default.addObserver(
        self,
        selector: #selector(handleAudioSessionRouteChange(_:)),
        name: AVAudioSession.routeChangeNotification,
        object: nil
    )
}

// 处理中断通知
@objc func handleAudioSessionInterruption(_ notification: Notification) {
    guard let info = notification.userInfo else { return }
    let type = info[AVAudioSessionInterruptionTypeKey] as? AVAudioSessionInterruptionType
    if type == .began {
        RTCAudioSession.sharedInstance().isAudioEnabled = false
    } else if type == .ended {
        let option = info[AVAudioSessionInterruptionOptionKey] as? AVAudioSessionInterruptionOption
        if option == .shouldResume {
            RTCAudioSession.sharedInstance().isAudioEnabled = true
        }
    }
}

// 处理路由变化通知
@objc func handleAudioSessionRouteChange(_ notification: Notification) {
    RTCAudioSession.sharedInstance().audioSessionRouteChange(notification)
}

记得在deinit里移除这些监听，避免内存泄漏。