SuperAPI AI 工具集

callkit

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:在 iOS 应用中实现与系统原生通话界面集成的 VoIP 通话功能,使用 CallKit 与 PushKit 完成来电、去电、音频会话及来电识别/拦截。

主要能力:使用 CXProvider 向系统报告通话并接收系统通话操作,CXCallController 发起去电、挂断、保持、静音等请求,CXCallUpdate 描述呼叫方名称、是否视频与句柄;通过 CXProviderDelegate 处理系统动作与音频会话事件;使用 PKPushRegistry 注册并接收 VoIP 推送。内容还涉及来电识别扩展(CXCallDirectoryProvider)、主应用通过 CXCallDirectoryManager 查询启用状态、打开“通话拦截与识别”设置并重载数据。

必要用法:需在 Signing & Capabilities 中开启 Voice over IP 后台模式、Push Notifications 能力,来电识别需添加 Call Directory Extension 目标。应用启动时创建并长期保留单个 CXProvider,并设置 delegate。收到必须上报的 VoIP 推送时,需在 PushKit 完成回调前调用 CallKit 上报来电,否则系统可能终止应用;iOS 26.4+ 可通过 PKVoIPPushMetadata.mustReport 判断是否必须上报。每次 didUpdate pushCredentials 都需将新 token 发送到服务器,VoIP 推送的 apns-expiration 应设为 0 或仅数秒。

使用方式:在 provider(:perform:) 中处理 CXAnswerCallAction、CXEndCallAction、CXStartCallAction 等动作,并在成功、取消、超时、网络错误等路径调用 fulfill() 或 fail();仅在 provider(:didActivate:) 后启动音频引擎,在 provider(_:didDeactivate:) 与重置路径停止音频。CXCallDirectoryPhoneNumber 需按国家代码加数字、升序存储,并预加载数据而非每次来电联网查询。

限制:资料未提供收费、价格、平台版本要求之外的部署信息或效果数据;部分具体实现细节需参考官方文档。