如何在iOS应用中发起外呼？CallKit代码拨号异常如何解决并获取通话起止时间

代码问题排查 #

• CXProviderConfiguration 初始化后未配置必要参数：苹果要求必须设置localizedName（系统通话记录显示的APP名称），同时要显式声明支持的 handle 类型，否则初始化无效无法发起呼叫
• 发起呼叫的UUID未提前保存：你直接生成一个临时UUID传入CXStartCallAction，后续无法对应到本次呼叫，用controller.callObserver.calls[0].uuid的写法非常容易出现数组越界崩溃，尤其是呼叫请求还未完全被系统同步到callObserver的场景
• 未配置项目基础权限：需要在Xcode项目的「Signing & Capabilities」中添加「Background Modes」能力，勾选「Voice over IP」选项，同时Info.plist要添加NSMicrophoneUsageDescription权限声明，否则系统会直接拦截呼叫请求
• reportOutgoingCall的时机不对：不要用固定1秒延迟，应该在CXProviderDelegate的provider:performStartCallAction:回调中执行呼叫成功上报，固定延迟容易出现时序问题

修正后可用代码 #

// 类成员变量，保存当前呼叫UUID和时间戳
private var currentCallUUID: UUID?
private var callStartTimestamp: TimeInterval?
private var callEndTimestamp: TimeInterval?

// 发起外呼逻辑
func startOutgoingCall(phoneNumber: String) {
    // 正确配置Provider参数
    let config = CXProviderConfiguration(localizedName: "你的应用名称")
    config.supportedHandleTypes = [.phoneNumber]
    config.includesCallsInRecents = true // 可选：是否将通话记录同步到系统通话列表
    
    let provider = CXProvider(configuration: config)
    provider.setDelegate(self, queue: DispatchQueue.main)
    let controller = CXCallController()
    
    // 提前保存本次呼叫的UUID，方便后续对应
    let callUUID = UUID()
    currentCallUUID = callUUID
    
    let startAction = CXStartCallAction(call: callUUID, handle: CXHandle(type: .phoneNumber, value: phoneNumber))
    let transaction = CXTransaction(action: startAction)
    
    controller.request(transaction) { [weak self] error in
        if let error = error {
            print("呼叫请求失败：\(error.localizedDescription)")
            return
        }
        // 可选：此处可以作为外呼发起时间戳，是系统接受呼叫请求的时间
        self?.callStartTimestamp = Date().timeIntervalSince1970
        print("外呼发起时间戳：\(self?.callStartTimestamp ?? 0)")
    }
}

// 实现CXProvider代理方法
extension YourViewController: CXProviderDelegate {
    func providerDidReset(_ provider: CXProvider) {}
    
    func provider(_ provider: CXProvider, perform action: CXStartCallAction) {
        // 系统回调确认要执行呼叫，此处上报外呼已连接
        provider.reportOutgoingCall(with: action.callUUID, connectedAt: Date())
        // 此处的时间是系统真正发起呼叫的时间，作为开始时间戳更准确
        callStartTimestamp = Date().timeIntervalSince1970
        action.fulfill()
    }
    
    func provider(_ provider: CXProvider, perform action: CXEndCallAction) {
        // 呼叫结束回调，所有结束场景（主动挂断、对方挂断、呼叫失败）都会触发此处
        callEndTimestamp = Date().timeIntervalSince1970
        print("外呼结束时间戳：\(callEndTimestamp ?? 0)")
        action.fulfill()
    }
}

时间戳捕获说明 #

• 外呼发起时间戳：推荐取provider:performStartCallAction:回调的时间，是系统真正触发呼叫的时间，比请求成功回调的时间更准确
• 外呼结束时间戳：统一在provider:performEndCallAction:回调中获取即可，覆盖所有呼叫结束场景

内容的提问来源于stack exchange，提问作者Manikandan.Gopal