iOS VoIP应用

3.1、概述

• 有关用户蜂窝服务提供商的信息

3.2、功能场景

• 可以通过唯一标识符获取是否可以在其网络上进行VoIP通话，从而屏蔽某些地域VoIP功能

• 可以获取到手机服务提供商的名称、ISO国家/地区代码、移动国家/地区代码（MCC）、移动网络代码

3.3、支持

• iOS 4.0+

• iPadOS 4.0+

• Mac Catalyst 13.1+

2、 CallKit如何控制

2.1、关于CallKit

下图比较形象的表达了应用程序与CallKit以及系统的关系：

CXProvider：

• 主要负责通话流程的控制，向系统注册通话和更新通话的连接状态等。

• 代表电话提供商对象，VoIP应用程序应该创建一个全局的实例，供使用，与系统双向通信。

CXCallController：

• 主要负责执行对通话的操作

• 呼叫控制器，当用户在应用程序内部进行的通讯操作时，可以使用这个类来通知系统，与系统双向通信

2.2、呼入、来电处理（CXProvider）

• 通过CXProviderConfiguration初始化一个全局的CXProvider实例，并指定代理&可选队列

• 接收到VOIP通知后弹出通话界面，需要使用CXProvider传递CXCallUpdate给系统来进行控制。如下图：
  

• 使用全局的CXProvider实例传递CXCallUpdate调起通话界面的简单的代码：
  

CXCallUpdate * callUpdate = [[CXCallUpdate alloc]init];
callUpdate.supportsGrouping = YES;
callUpdate.supportsDTMF = YES;
callUpdate.hasVideo = YES;
callUpdate.supportsHolding = YES;
[callUpdate setLocalizedCallerName:nickName];
CXHandle * handle = [[CXHandle alloc]initWithType:CXHandleTypePhoneNumber value:from];
callUpdate.remoteHandle = handle;
 [[self shareInstance].callProvider reportNewIncomingCallWithUUID:[self shareInstance].uuid update:callUpdate completion:^(NSError * _Nullable error) {
     LOG(@"吊起界面");
}];

• 之后系统会将一些用户操作通过CSAction传递给APP，如下：
  

• 在CXProviderDelegate中处理这些系统回调事件
  

//当接收到呼叫重置时 调用的函数，这个函数必须被实现，其不需做任何逻辑，只用来重置状态
- (void)providerDidReset:(CXProvider *)provider;
//呼叫开始时回调 
- (void)providerDidBegin:(CXProvider *)provider;
//音频会话激活状态的回调
- (void)provider:(CXProvider *)provider didActivateAudioSession:(AVAudioSession *)audioSession;
//音频会话停用的回调
- (void)provider:(CXProvider *)provider didDeactivateAudioSession:(AVAudioSession *)audioSession;
//行为超时的回调 
- (void)provider:(CXProvider *)provider timedOutPerformingAction:(CXAction *)action;
//有事务被提交时调用 
//如果返回YES 则表示事务被捕获处理 后面的回调都不会调用 如果返回NO 则表示事务不被捕获，会回调后面的函数
- (BOOL)provider:(CXProvider *)provider executeTransaction:(CXTransaction *)transaction;
//点击开始按钮的回调
- (void)provider:(CXProvider *)provider performStartCallAction:(CXStartCallAction *)action;
//点击接听按钮的回调
- (void)provider:(CXProvider *)provider performAnswerCallAction:(CXAnswerCallAction *)action;
//点击结束按钮的回调
- (void)provider:(CXProvider *)provider performEndCallAction:(CXEndCallAction *)action;
//点击保持通话按钮的回调
- (void)provider:(CXProvider *)provider performSetHeldCallAction:(CXSetHeldCallAction *)action;
//点击静音按钮的回调
- (void)provider:(CXProvider *)provider performSetMutedCallAction:(CXSetMutedCallAction *)action;
//点击组按钮的回调
- (void)provider:(CXProvider *)provider performSetGroupCallAction:(CXSetGroupCallAction *)action;
//DTMF功能回调
- (void)provider:(CXProvider *)provider performPlayDTMFCallAction:(CXPlayDTMFCallAction *)action;

• 锁屏和应用程序在后台的效果分别如下所示：
  

通过CXProviderDelegate相关函数来处理系统通话界面的某些操作回调给应用程序。

2.3、呼出，拨号处理（CXCallController）

• APP中进行的操作如果需要通知系统，需要使用CXCallController通过CXTransaction传递。

• 创建一个新的呼叫控制器CXCallController，可用指定队列创建。获取活动调用观察者CXCallObserver指定观察者的代理CXCallObserverDelegate

• 实例化一个CXStrartCallAction（发起呼出呼叫的行为封装），由唯一标识呼叫的UUID和指定接收方的对象CXHandle组成 

• 再使用CXStrartCallAction实例创建CTTransaction实例

• 通过CXCallController的requestTransaction....将行为通知给系统

let uuid = UUID()let handle = CXHandle(type: .emailAddress, value: "jappleseed@apple.com") let startCallAction = CXStartCallAction(call: uuid)startCallAction.destination = handle 
let transaction = CXTransaction(action: startCallAction)callController.request(transaction) { error in
    if let error = error {
        print("Error requesting transaction: \(error)")
    } else {
        print("Requested transaction successfully")
    }}

• 接收者接听电话后，系统调用CXProvider的代理方法：
  

接听者在这个方法中配置音视频回话（第2部分有举例）

//点击开始按钮的回调
- (void)provider:(CXProvider *)provider performStartCallAction:(CXStartCallAction *)action;

• APP中的其他操作也可以举一反三：例如App内的通讯需要添加到系统的历史通话列表：

• 通过CXCallObserverDelegate回调来处理系统事件 
  

extension ViewController: CXCallObserverDelegate {
    func callObserver(_ callObserver: CXCallObserver,callChanged call: CXCall) {

        if call.isOutgoing {

            print("电话播出")

            if call.hasConnected {
                print("电话接通")
                operation(state: CurrentState.HasConnected)
            }
            if call.hasEnded {
                print("电话挂断")
                operation(state: CurrentState.HasEnded)
            }
            if call.isOnHold {
                print("无人接听挂断")
                operation(state: CurrentState.IsOnHold)
            }
        } else {
            print("other error")
        }
    }}

2.4、来电拦截与号码识别（CXCallDirectoryExtension）

上面介绍了CallKit的结合PushKit&VoIP可实现的通讯功能，有通讯功能就需要进行联系人识别与黑名单。

社交网络应用程序有一个Call Directory应用程序扩展程序，可以下载并添加用户所有朋友的电话号码。

因此，当用户接到Jane的来电时，系统会显示类似“（应用程序名称）来电显示：Jane Appleseed”而不是“未知来电者”。

CallKit框架中还有一部分内容可以结合Call Directory Extension来实现号码拦截与识别。

Call Directory Extension：

• CXCallDirectoryProvider：主机应用程序的Call Directory应用程序扩展的主要对象。

• CXCallDirectoryExtensionContext：用于向Call Directory应用程序扩展添加标识和阻止条目的程序化界面。

• CXCallDirectoryExtensionContextDelegate：当请求失败时，Call Directory扩展上下文对象调用的方法集合。

• CXCallDirectoryManager：管理Call Directory应用程序扩展的对象的程序化界面。

2.4.1、创建应用扩展target

• 选择Call Directory Extension：
  

主程序会自动生成Call Directory应用程序扩展的主要对象（继承自CXCallDirectoryProvider的Handler）。

• 应用程序通知扩展程序更新号码库（切换app账号等场景）
  

CXCallDirectoryManager的api就比较简单了，凭场景组合使用：

CXCallDirectoryManager
/// 单例
@property (readonly, class) CXCallDirectoryManager *sharedInstance;
/// 利用扩展程序bundle id（在extension的info.plist中）来查询是否开启来电识别 
func getEnabledStatusForExtension(withIdentifier: String, completionHandler: (CXCallDirectoryManager.EnabledStatus, Error?) -> Void)
/// 通知系统更新（主app与extension的数据通信、参考group共享数据的编程方式来实现）
func reloadExtension(withIdentifier: String, completionHandler: ((Error?) -> Void)?)
/// 打开设置页面
func openSettings(completionHandler: ((Error?) -> Void)?)

• 扩展程序中的增删电话操作
  

系统默认生成的应用程序扩展的主要对象中已经替我们优雅的生成了必要的代码，我们仅需取group（主程序给扩展程序使用的数据）中取出来设置就可以

override func beginRequest(with context: CXCallDirectoryExtensionContext) {
        context.delegate = self
    // Check whether this is an "incremental" data request. If so, only provide the set of phone number blocking
    // and identification entries which have been added or removed since the last time this extension's data was loaded.
    // But the extension must still be prepared to provide the full set of data at any time, so add all blocking
    // and identification phone numbers if the request is not incremental.
    if context.isIncremental {
        addOrRemoveIncrementalBlockingPhoneNumbers(to: context)
        addOrRemoveIncrementalIdentificationPhoneNumbers(to: context)
    } else {
        addAllBlockingPhoneNumbers(to: context)
        addAllIdentificationPhoneNumbers(to: context)
    }
    context.completeRequest()}

• CXCallDirectoryExtensionContext是操作上下文，不需要初始化，会自系统的方法传递出来
  

//是否支持增量更新
@property (nonatomic, readonly, getter=isIncremental) BOOL incremental API_AVAILABLE(ios(11.0));
//添加一个黑名单号码
- (void)addBlockingEntryWithNextSequentialPhoneNumber:(CXCallDirectoryPhoneNumber)phoneNumber;
//移除一个黑名单号码
- (void)removeBlockingEntryWithPhoneNumber:(CXCallDirectoryPhoneNumber)phoneNumber API_AVAILABLE(ios(11.0));
//移除所有的黑名单号码
- (void)removeAllBlockingEntries API_AVAILABLE(ios(11.0));
//添加一个身份识别
- (void)addIdentificationEntryWithNextSequentialPhoneNumber:(CXCallDirectoryPhoneNumber)phoneNumber label:(NSString *)label;
//移除一个身份识别
- (void)removeIdentificationEntryWithPhoneNumber:(CXCallDirectoryPhoneNumber)phoneNumber API_AVAILABLE(ios(11.0));
//移除所有身份识别
- (void)removeAllIdentificationEntries API_AVAILABLE(ios(11.0));
//完成操作后 需要手动调用此函数
- (void)completeRequestWithCompletionHandler:(nullable void (^)(BOOL expired))completion;