Flutter iOS后台状态下如何显示全屏来电界面？

核心原因分析 #

你遇到的URL scheme报错本质是iOS安全机制限制：后台应用无权限通过URL scheme直接唤起前台，未授权的操作会被系统拦截，这就是报错中"neither visible nor entitled"的核心原因。WhatsApp这类应用实现的后台全屏来电，依赖的是iOS官方提供的CallKit框架，这是实现系统级来电界面的唯一合法途径。

具体实现步骤 #

1. 集成CallKit框架 #

CallKit是iOS专为语音/视频通话设计的系统框架，支持在后台、锁屏状态下触发原生来电界面，且拥有合法权限直接唤起应用到前台。

• 在Xcode中添加CallKit依赖，导入头文件：

  #import <CallKit/CallKit.h>
  

  Swift版本：

  import CallKit
  

2. 实现CallKit核心逻辑 #

需要实现CXProviderDelegate协议处理来电请求：

• 创建CXProvider实例并配置通话属性：

  let config = CXProviderConfiguration(localizedName: "你的应用名称")
  config.supportsVideo = true
  config.iconTemplateImageData = UIImage(named: "通话图标")?.pngData()
  let provider = CXProvider(configuration: config)
  provider.setDelegate(self, queue: DispatchQueue.main)
  

• 收到后台来电推送时，发起系统来电请求：

  let callUpdate = CXCallUpdate()
  callUpdate.remoteHandle = CXHandle(type: .generic, value: "来电用户名称")
  callUpdate.hasVideo = true
  provider.reportNewIncomingCall(with: UUID(), update: callUpdate, completion: { error in
      if let error = error {
          // 处理来电请求失败逻辑
      }
  })
  

3. 配置后台权限 #

确保应用开启必要的后台权限：

• 在Info.plist中添加UIBackgroundModes，包含voip和remote-notification：

  <key>UIBackgroundModes</key>
  <array>
      <string>voip</string>
      <string>remote-notification</string>
  </array>
  

• 开启Push Notifications权限，且必须使用VOIP推送（普通远程推送无法保证实时性，VOIP推送会被系统优先处理）。

4. 处理用户来电响应 #

在CXProviderDelegate代理方法中处理用户接听/挂断操作，同时唤起应用到前台：

func provider(_ provider: CXProvider, perform action: CXAnswerCallAction) {
    // 导航到通话界面
    let callVC = 你的通话界面ViewController()
    UIApplication.shared.windows.first?.rootViewController?.present(callVC, animated: true)
    action.fulfill()
}

func provider(_ provider: CXProvider, perform action: CXEndCallAction) {
    // 处理挂断逻辑
    action.fulfill()
}

5. 关键注意事项 #

• CallKit的来电界面为系统统一样式，可通过CXProviderConfiguration修改图标、应用名称等，但无法完全自定义布局。
• 必须通过VOIP推送触发CallKit请求，普通远程推送在后台无法稳定唤醒应用。
• 测试需使用真实iOS设备，模拟器不支持CallKit和VOIP推送功能。

非系统级界面替代方案 #

若不想使用CallKit的原生界面，可通过本地通知+UserNotifications框架实现自定义弹窗，但这种方式无法直接唤起应用到前台，需用户主动点击通知进入，体验远不如CallKit。

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