iOS10新特性之CallKit开发详解：锁屏接听和来电识别

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

---

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

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

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

---

二、看看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
 {
     [_callController requestTransaction:transaction completion:^( NSError *_Nullable error){
         if (error !=nil) {
             NSLog(@"Error requesting transaction: %@", error);
         }else{
             NSLog(@"Requested transaction successfully");
         }
     }];
 }

2、告知系统外呼一个电话的信息

请求系统代为接听来电：

 - (NSUUID *)reportIncomingCallWithContact:(XWContact *)contact completion:(XWCallKitCenterCompletion)completion
 {
     NSString * number = contact.phoneNumber;
     CXHandle* handle=[[CXHandle alloc]initWithType:CXHandleTypePhoneNumber value:number];
     NSUUID *callUUID = [NSUUID UUID];

     CXCallUpdate *callUpdate = [[CXCallUpdate alloc] init];
     callUpdate.remoteHandle = handle;
     callUpdate.localizedCallerName = contact.displayName;
     [self.provider reportNewIncomingCallWithUUID:callUUID update:callUpdate completion:completion];
     return callUUID;
 }

3、系统听话记录或者联系人里通话发给app，app如何接受这个NSUserActivity，并发起点VoIP电话请求；

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

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

＊＊＊＊＊＊分享这些一来来是回答网友的问询，二来自己总结一下思路清晰点；不喜欢发代码和Demo ，授之以鱼不如授之以渔，自己看懂了自己写个demo跑一下比看别人写的再规范的demo都好，但是如果还是有需要下次再发简版demo。

---

随手写的，欢迎指正，欢迎交流，微博：_viviwu_；简书 QQ：286218985；

原创文字，转载必须注明原文链接。