iOS10新特性之CallKit适配VoIP详解

国庆节过完了，回家好好休息一天，今天好好分享一下CallKit开发。最近发现好多吃瓜问CallKit的VoIP开发适配，对iOS10的新特性开发和适配也在上个月完成，接下来就分享一下VoIP应用如何使用CallKit后台、锁屏接听和号码识别功能。

一、首先使用CallKit能做什么：（一句话，不仅让VoIP应用具有系统电话一样的功能，还能帮助系统实现来电识别等功能；但本身并不具备voip功能）

1.后台或锁屏时直接通过系统电话界面接管VoIP语音来电，并更新回调电话操作到app（包括接听、挂断、暂停/保留、静音、DTMF信息等等）；

2.电话黑名单拦截和来电识别拓展功能（这个大家在安卓XX手机管家、卫士上司空见惯了）

3.强调一下CallKit的主要功能是作为平台管理包括VoIP在内的电话，提供统一接听操作管理入口和权限。而不仅仅是有人以为的做提供来电识别拓展的！！！

二、看看CallKit的API类簇功能吧：

1、CXCall：电话信息基类，有一个唯一识别符UUID，是系统用以区分一个唯一来电信息的东西、通过这个ID可以地位到特定时刻的特定号码的来电信息。

2、CXCallUpdate：通话过程就是信息和状态的变化过程，CallKit的作用只是在于将通话状态和信息在系统接听界面和应用之间传递 ，通过provider请求进行处理；

3、CXAction/CXCallAction：电话操作载体类，细分包括（电话开始:CXStartCallAction、 接听:CXAnswerCallAction、暂停：CXSetHeldCallAction、静音：CXSetMutedCallAction、群组电话CXSetGroupCallAction、双频多音功能：CXPlayDTMFCallAction、挂断或拒接：CXEndCallAction  ）。

4、CXTransaction：操作执行类；CXCallController：话务控制器，每种action在配置好CXTransaction后都需要控制器CXCallController去向系统发起请求来响应操作：- (void)requestTransaction:(CXTransaction *)transaction completion:(void (^)(NSError *_Nullable error))completion;

5、CXProvider／CXProviderDelegate：使用CallKit代接收来电状态的VoIP应用都需要一个初始化一个CXProvider，比如有来电时通过provider告知系统帮我接听、要呼出电话时告知系统这条电话的基本信息、以及各种操作和状态的更新信息会通过协议代理传回应用；并需要设置一个代理类来接受处理CXProviderDelegate 代理任务操作（各种CXAction：接听、挂断、DTMF、免提等本地操作）。使用之前，通过 CXProviderConfiguration来配置app的具体信息（你的VoIP 自己的显示名称、是否要支持视频通话、最大会话分组数、logo、来电提示音等信息），以便在系统通话界面显示。

6、CXCallObserver可以设置一个代理来随时捕获电话信息的更新；

7、＊＊＊＊＊＊接下来是app extension相关的API类：CXCallDirectory电话的地址，目前只有号码CXCallDirectoryPhoneNumber；CXCallDirectoryExtensionContext：拓展应用中用来接受黑名单号码信息和号码识别信息数据源的类；

三、如何使用和需要哪些：

1、初始化一个CXProvider、CXCallController，看看API，配置好代理，准备接受CXCallUpdate；每一种CXCallAction对应一个CXTransaction去执行，因为他有一个管理队列/// Add the provided action to the receiver's list of actions   - (void)addAction:(CXAction *)action;

//无论何种操作都需要 话务控制器 去 提交请求 给系统

-(void)requestTransaction:(CXTransaction *)transaction completion:(XWCallKitCenterCompletion)completion

 -(void)requestTransaction:(CXTransaction *)transaction{

[_callController requestTransaction:transaction completion:^( NSError *_Nullable error){

if (error !=nil) {

NSLog(@"Error requesting transaction: %@", error);

}else{

NSLog(@"Requested transaction successfully");

}

}];

}

2、在后台或者锁屏时，请求系统代为接听来电（这才是CallKit的主要功能）：

[provider reportNewIncomingCallWithUUID:uuid update:update completion:^(NSError * _Nullable error) {

if (error == nil) {

XWCall *call = [[XWCall alloc] initWithUUID:uuid];

call.handle = handle; 

[[XWCallManager sharedManager] addCall:call];

}

completion(error);

}];

3、使用Siri识别来拨打电话、在系统听话记录里回拨等UserActivity回调到你的VoIP网络电话app里，app如何接受这个UserActivity，并发起点VoIP电话请求：详见demo

4、至于做这个号码识别和黑名单拦截就更简单了，你在工程中添加CallDiretoryExtension拓展的时候，它就帮你写好代码了，看懂了自定义数据源就可以了。不过这个功能多数情况没效果，大概是系统权限或者bug吧。

5、另外iOS10已经警告VoIP功能的应用去使用PushKit来接受来电推送，以往的VoIP后台申请不受支持。具体代码很简单，跟remote notification差不多:PKPushRegistry看看API就知道怎么耍了。

＊＊＊＊＊＊分享这些一来来是回答网友的问询，二来自己总结一下思路清晰点；不喜欢发代码和Demo ，授之以鱼不如授之以渔，自己看懂了自己写个demo跑一下比看别人写的再规范的demo都好，但是如果还是有需要下次再发简版demo。再次强调，callKit但本身并不具备voip功能，不要以为单纯接入CallKit就可以真正童话了，自己本身要具备语音通话功能。

潜水了几年，最近觉得朋友和boss说多敲也要多分享总结交流，也许有道理吧，以后有空就吓写写吧！随手写的，欢迎指正，对voip感兴趣的欢迎交流。本人自己制作的voip语音视频通话SDK，需要的联系我：微博：_viviwu_；

既然有不少人没搞懂，还是发个简单的CallKit demo吧，star一下手留余香！用objective-C 写的一个简版CallKit Demo，展示iOS10 CallKit的使用介绍 CallKit的基本使用。