Swift开发：如何用CallKit自动拒接指定来电并解决报错？

错误原因 #

你遇到的Code=2错误对应CXErrorCodeRequestTransactionUnknownCallProvider，本质是：你尝试结束的系统来电属于iOS自带的电话Provider，你的App没有权限直接操作该Provider；同时你的App未注册自身的CallKit Provider，导致CallKit找不到对应处理方，从而报错。

修复步骤与正确实现逻辑 #

1. 注册自定义CXProvider #

使用CallKit操作通话的前提是注册自己的CXProvider，修改代码如下：

import CallKit

class CallTest: NSObject, CXCallObserverDelegate, CXProviderDelegate, ObservableObject {
    @Published var incomingCallNumber: String?
    
    let callObserver = CXCallObserver()
    let provider: CXProvider
    let callController = CXCallController()

    override init() {
        // 配置Provider基础信息
        let config = CXProviderConfiguration(localizedName: "自定义来电拦截")
        config.supportsVideo = false
        config.maximumCallsPerCallGroup = 1
        config.supportedHandleTypes = [.phoneNumber]
        
        provider = CXProvider(configuration: config)
        super.init()
        
        callObserver.setDelegate(self, queue: .main)
        provider.setDelegate(self, queue: .main)
        // 初始化Provider
        provider.initialize()
    }
    
    // MARK: - CXCallObserverDelegate
    func callObserver(_ callObserver: CXCallObserver, callChanged call: CXCall) {
        guard call.isOutgoing == false, call.hasConnected == false, call.uuid != nil else {
            return
        }
        
        // 替换为用户指定的拦截号码
        let targetNumber = "1234567890"
        if incomingCallNumber == targetNumber {
            declineCall(callUUID: call.uuid)
        }
    }
    
    // MARK: - 拒接通话方法
    private func declineCall(callUUID: UUID) {
        let endAction = CXEndCallAction(call: callUUID)
        let transaction = CXTransaction(action: endAction)
        
        callController.request(transaction) { error in
            if let error = error {
                print("拒接失败: \(error.localizedDescription)")
            } else {
                print("已成功拒接")
            }
        }
    }
    
    // MARK: - CXProviderDelegate（必须实现的基础方法）
    func providerDidReset(_ provider: CXProvider) {}
    func provider(_ provider: CXProvider, perform action: CXStartCallAction) {
        action.fulfill()
    }
    func provider(_ provider: CXProvider, perform action: CXAnswerCallAction) {
        action.fulfill()
    }
    func provider(_ provider: CXProvider, perform action: CXEndCallAction) {
        action.fulfill()
    }
}

2. 无通知拦截的最优方案：Call Directory Extension #

如果需要完全不显示来电通知就自动拒接指定号码，上述方法无法满足（系统来电通知会先弹出），此时应使用iOS系统级的Call Directory Extension，它能在系统层面直接拦截来电：

实现步骤：

1. 在Xcode中添加Call Directory Extension目标
2. 在Extension实现类中编写拦截逻辑
3. 用户需在系统设置中开启App的"电话拦截"权限

示例Extension代码：

import CallKit

class CallDirectoryHandler: CXCallDirectoryProvider, CXCallDirectoryExtensionContextDelegate {

    override func beginRequest(with context: CXCallDirectoryExtensionContext) {
        context.delegate = self
        
        // 添加需要拦截的号码（支持前缀匹配）
        let blockedNumbers = ["1234567890", "9876543210"]
        for number in blockedNumbers {
            if let phoneNumber = CXCallDirectoryPhoneNumber(number) {
                context.addBlockingEntry(withNextSequentialPhoneNumber: phoneNumber)
            }
        }
        
        context.completeRequest()
    }

    func requestFailed(for extensionContext: CXCallDirectoryExtensionContext, withError error: Error) {
        // 处理请求失败逻辑
    }
}

注意事项 #

• 无论使用哪种方案，都需在Info.plist中添加NSMicrophoneUsageDescription（CallKit权限要求）
• Call Directory Extension需要用户手动开启权限：设置 > 电话 > 来电阻止与身份识别 > 开启你的App
• iOS对CallKit使用有严格限制，请勿滥用，避免App审核被拒

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