用途:在 iOS 应用中构建与系统原生通话界面集成的 VoIP 通话功能,覆盖来电与去电流、VoIP 推送注册、音频会话协调以及来电识别/拦截扩展,目标为 Swift 6.3 / iOS 26+。
主要能力:使用 CXProvider 向系统上报通话并接收通话操作,CXCallController 发起开始、结束、保持、静音等操作,CXCallUpdate 描述主叫名称、视频与句柄等元数据,CXProviderDelegate 处理系统通话动作与音频会话事件,PKPushRegistry 注册并接收 VoIP 推送,CXCallDirectoryProvider 提供来电识别与拦截。
使用方式:在 Signing & Capabilities 中启用 Voice over IP 后台模式与推送通知能力,来电识别需添加 Call Directory Extension 目标。应用启动时创建并长期持有单个 CXProvider,用 CXProviderConfiguration 配置能力,并在上报任何通话前设置 delegate。收到 VoIP 推送后必须立即上报来电,否则系统会终止应用。去电通过 CXCallController 请求 CXStartCallAction。音频引擎只能在 provider(_:didActivate:) 回调后启动,并在 didDeactivate 中停止;音频会话类别设为 .playAndRecord、模式 .voiceChat。VoIP 推送令牌每次变化都要发送到服务器。Call Directory 电话号码须按 E.164 升序添加,数据变更后从主应用调用 reloadExtension 重载扩展。
适用场景:需要系统级来电界面、VoIP 推送唤醒、通话音频协调或来电识别与拦截的 iOS 应用。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;实现细节以 Apple 官方框架文档为准。