iOS后台/终止状态下VoIP推送不可靠问题求助

问题描述 #

需实现可靠的VoIP推送通知，确保应用在后台或终止状态下仍能接收来电。当前前台推送正常，但后台/终止状态下接收断断续续，部分场景完全无法收到通知，且pushRegistry(_:didReceiveIncomingPushWith:for:)方法未触发。

环境 #

• 工具：Swift、Xcode
• 框架：PushKit、CallKit

现象 #

• 应用前台时VoIP推送正常接收
• 应用后台或终止时推送接收断断续续
• 日志无错误，但pushRegistry(_:didReceiveIncomingPushWith:for:)方法未被触发

相关代码 #

PushKit注册代码 #

func registerForVoIPPushes() {
    self.voipRegistry = PKPushRegistry(queue: nil)
    self.voipRegistry?.delegate = self
    self.voipRegistry?.desiredPushTypes = [.voIP]
}

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    registerForVoIPPushes()
    return true
}

Push Registry处理代码 #

func pushRegistry(_ registry: PKPushRegistry,
                  didReceiveIncomingPushWith payload: PKPushPayload,
                  for type: PKPushType) {
    guard let payloadInfo = payload.dictionaryPayload["data"] as? [AnyHashable: Any] else {
        print("Unidentifiable payload data received")
        return
    }
    print("pushRegistry didReceiveIncomingPushWith \(payloadInfo)")

    guard
        type == .voIP,
        let callId = payloadInfo["callId"] as? String,
        let _ = payloadInfo["deviceId"] as? String,
        let sender = payloadInfo["senderName"] as? String,
        let type = payloadInfo["type"] as? String
    else {
        print("Unknown PushKit notification received")
        return
    }

    let uuid = GlobalMethods().uuidFromString(callId)
    switch type {
    case "NewVoipCallStarted":
        CallManager.shared.processForIncomingCall(sender: sender, uuid: uuid)
    case "CancelVoipCall":
        CallManager.shared.cancelIncomingCall(uuid: uuid)
    default:
        print("Unknown type of voIP notification received")
        return
    }
}

CallKit集成代码 #

func processForIncomingCall(sender: String, uuid: UUID) {
    let configuration = CXProviderConfiguration()
    configuration.supportsVideo = true
    configuration.includesCallsInRecents = true
    configuration.supportedHandleTypes = [.generic]
    configuration.maximumCallsPerCallGroup = 1
    configuration.includesCallsInRecents = true
    
    provider = CXProvider(configuration: configuration)
    provider?.setDelegate(self, queue: nil)
    
    let update = CXCallUpdate()
    update.remoteHandle = CXHandle(type: .generic, value: sender)
    update.hasVideo = true
    
    provider?.reportNewIncomingCall(with: uuid, update: update) { error in
        if let error = error {
            print("Error reporting incoming call: \(error.localizedDescription)")
        } else {
            print("Incoming call successfully reported.")
        }
    }
}

已尝试操作 #

• 确认VoIP推送证书有效且已正确上传
• 使用Apple开发者控制台测试VoIP推送
• 验证payload包含content-available:1和apns-priority:10
• 确保应用每次启动都注册PushKit的.voIP推送类型
• 确认应用已开启Background Modes权限并包含VoIP选项
• 多次检查服务器推送逻辑正确性
• 排查pushRegistry(_:didReceiveIncomingPushWith:for:)方法是否被调用

针对性修复建议 #

1. 优化PushKit注册逻辑 #

• 指定专用串行队列避免线程冲突，确保应用从终止状态唤醒时重新注册：

  func registerForVoIPPushes() {
      let voipQueue = DispatchQueue(label: "com.yourapp.voip.processing")
      self.voipRegistry = PKPushRegistry(queue: voipQueue)
      self.voipRegistry?.delegate = self
      self.voipRegistry?.desiredPushTypes = [.voIP]
  }
  

• 实现token更新回调，及时同步到服务器：

  func pushRegistry(_ registry: PKPushRegistry, didUpdate pushCredentials: PKPushCredentials, for type: PKPushType) {
      guard type == .voIP else { return }
      let tokenString = pushCredentials.token.map { String(format: "%02x", $0) }.joined()
      // 将token上传至服务器替换旧token
      print("Updated VoIP Token: \(tokenString)")
  }
  

2. 规范CallKit初始化与实现 #

• 将CXProvider改为全局单例，避免重复创建：

  class CallManager: NSObject, CXProviderDelegate {
      static let shared = CallManager()
      private(set) var provider: CXProvider!
      
      private override init() {
          super.init()
          let config = CXProviderConfiguration(localizedName: "你的应用名称")
          config.supportsVideo = true
          config.includesCallsInRecents = true
          config.supportedHandleTypes = [.generic]
          config.maximumCallsPerCallGroup = 1
          // 添加应用图标模板，提升系统识别度
          if let iconData = UIImage(named: "AppIcon")?.pngData() {
              config.iconTemplateImageData = iconData
          }
          provider = CXProvider(configuration: config)
          provider.setDelegate(self, queue: nil)
      }
      
      func processForIncomingCall(sender: String, uuid: UUID) {
          let update = CXCallUpdate()
          update.remoteHandle = CXHandle(type: .generic, value: sender)
          update.hasVideo = true
          
          provider.reportNewIncomingCall(with: uuid, update: update) { error in
              if let error = error {
                  print("Report incoming call failed: \(error.localizedDescription)")
              }
          }
      }
      
      // 必须实现的CXProviderDelegate方法，否则系统会限制推送
      func provider(_ provider: CXProvider, perform action: CXAnswerCallAction) {
          action.fulfill()
      }
      
      func provider(_ provider: CXProvider, perform action: CXEndCallAction) {
          action.fulfill()
      }
  }
  

3. 修正推送Payload与服务器配置 #

• iOS 13+必须添加apns-push-type: voip请求头，使用VoIP专用APNs服务器：
  • 开发环境：api.sandbox.push.apple.com:443
  • 生产环境：api.push.apple.com:443
• Payload无需content-available:1，正确格式示例：

  {
      "aps": {
          "alert": "来电提醒"
      },
      "data": {
          "callId": "123456",
          "deviceId": "abcdef",
          "senderName": "张三",
          "type": "NewVoipCallStarted"
      }
  }
  

4. 系统权限与应用稳定性检查 #

• 确认用户开启了后台App刷新权限（设置→通用→后台App刷新）
• 排查应用崩溃、内存泄漏问题，避免被系统标记为不稳定应用而限制后台唤醒
• 必须使用真实设备测试，模拟器不支持VoIP推送后台唤醒

5. 调试日志优化 #

• 在didFinishLaunchingWithOptions中检测是否由VoIP推送唤醒：

  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
      registerForVoIPPushes()
      if launchOptions?[.pushNotification] != nil {
          print("App launched by VoIP push notification")
      }
      return true
  }
  

• 使用Xcode的Debug→Attach to Process by PID or Name连接终止状态的应用，查看推送唤醒时的日志输出

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