iOS CallKit+PJSIP多通话功能异常技术问询

嘿，我之前在做iOS CallKit多通话功能时也踩过这些坑，结合你的场景给你几个具体的排查和修复方向：

一、修复“保持当前通话接听第二通时新通话无音频”问题 #

CallKit的音频会话管理是多通话场景的核心，大概率是音频会话的激活和配置没处理好：

• 确保正确处理AVAudioSession的多通话配置
  在CXProviderDelegate的provider:didActivateAudioSession:方法里，不能只处理单一通话的情况。当有通话保持并接听新通话时，需要重新配置音频会话的category和选项：

  func provider(_ provider: CXProvider, didActivate audioSession: AVAudioSession) {
      do {
          // 多通话场景下需要设置正确的category和选项
          try audioSession.setCategory(.playAndRecord, mode: .voiceChat, options: [.allowBluetooth, .duckOthers])
          try audioSession.setActive(true)
      } catch {
          print("激活音频会话失败: \(error.localizedDescription)")
      }
  }
  

  另外，当切换通话状态（比如从保持切到活跃）时，要记得重新激活对应通话的音频通道，不要让之前的音频会话占用资源。

• 检查通话状态更新的时序
  接听第二通电话前，必须先通过CXCallController给第一通通话发送保持请求，确保系统先标记第一通为保持状态，再处理第二通的接听：

  // 保持当前活跃通话
  let holdAction = CXSetHeldCallAction(callUUID: activeCallUUID, onHold: true)
  let transaction = CXTransaction(action: holdAction)
  callController.request(transaction) { error in
      if let error = error {
          print("保持通话失败: \(error.localizedDescription)")
          return
      }
      // 保持成功后，再处理第二通通话的接听逻辑
      self.answerIncomingCall(incomingCallUUID)
  }
  

  如果跳过这个步骤直接接听新通话，系统的音频路由可能会混乱，导致新通话没有音频。

• 验证音频单元的关联
  如果你使用了自定义的音频引擎（比如WebRTC），要确保每个通话的音频轨道和CallKit的音频会话正确绑定。当新通话建立时，要暂停保持通话的音频流，激活新通话的音频流，不要让两个流同时占用音频设备。

二、修复“CallKit通话切换按钮禁用”问题 #

切换按钮需要满足CallKit的特定条件才会启用，主要检查以下几点：

• 初始化通话时设置正确的支持属性
  在创建CXCallUpdate时，必须开启supportsHolding、supportsGrouping和supportsUngrouping属性，告诉系统你的通话支持保持和切换：

  let update = CXCallUpdate()
  update.remoteHandle = CXHandle(type: .generic, value: callerID)
  update.supportsHolding = true
  update.supportsGrouping = true
  update.supportsUngrouping = true
  update.hasVideo = false
  provider.reportNewIncomingCall(with: callUUID, update: update, completion: completion)
  

  如果这些属性没设为true，系统会默认禁用切换按钮。

• 确保通话状态正确同步到CallKit
  当你手动保持或恢复通话时，必须通过CXCallController发送对应的状态更新请求，让系统准确知道每个通话的状态（活跃/保持）：

  // 恢复保持的通话并将当前活跃通话设为保持
  let unholdAction = CXSetHeldCallAction(callUUID: heldCallUUID, onHold: false)
  let holdCurrentAction = CXSetHeldCallAction(callUUID: activeCallUUID, onHold: true)
  let transaction = CXTransaction(actions: [unholdAction, holdCurrentAction])
  callController.request(transaction) { error in
      if let error = error {
          print("切换通话失败: \(error.localizedDescription)")
      }
  }
  

  只有当系统检测到存在一个活跃通话和至少一个保持通话时，切换按钮才会自动启用。

• 检查CXCallObserver的监听逻辑
  如果你的APP依赖CXCallObserver监听通话状态，要确保它能正确捕获到所有通话的状态变化。如果监听逻辑有遗漏，可能导致APP和系统的通话状态不同步，进而禁用切换按钮。

最后再做几个验证 #

1. 测试时用真实设备（模拟器的CallKit功能有限）
2. 查看Xcode的控制台日志，有没有CallKit相关的错误提示（比如权限问题、请求失败）
3. 确认你的APP已经获取了voIP权限，并且在Info.plist里正确配置了UIBackgroundModes包含voip

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