呼叫组件（NERTCCallkit）通过 UI 组件化的方式，简化了呼叫流程，您只需要调用几行代码，就可以实现 1 对 1 呼叫，并包含呼叫的 UI 界面。本文介绍呼叫组件 V2 版本的集成和实现方法。

注意事项

• 呼叫组件默认使用调试模式。应用正式上线前，请在控制台中将指定应用的鉴权方式改回安全模式。安全模式下需要使用 Token 加入房间，详细说明请参见Token 鉴权。
• 针对组件中的回调信息，开发者要做好相应回调数据的上报及存储，以便于后期上线之后排查问题。

开发环境

在开始运行工程之前，请您准备以下开发环境：

• Xcode 14 及以上版本。
• iOS 10.0 及以上版本的 iOS 设备。
• 已安装 CocoaPods。

准备工作

• 已创建应用并获取 AppKey。

• 已开通 IM 即时通讯、音视频通话 2.0 及信令产品。

• 已开通话单功能。

集成呼叫组件

步骤1 集成 IM SDK

1. 在 SDK 下载页面查看 IM SDK 的最新版本，并查询本地仓库中对应的版本是否为最新版本。

   若不是最新版本，建议先更新本地仓库，以确保可以集成最新的 SDK 版本。

   pod search NIMSDK_LITE   //本地仓库中查询 NIMSDK_LITE 信息
   pod repo update          //更新本地仓库
   

2. 在项目根目录下的 Podfile 文件中写入以下内容。

   pod 'NIMSDK_LITE' 
   

3. 执行以下命令安装 IM SDK。

   pod install
   

步骤 2：初始化 IM SDK

将 IM SDK 集成到客户端后，需要先完成 IM SDK 的初始化才能使用其他功能。

1. 在项目文件中引入头文件 NIMSDK.h。

#import <NIMSDK/NIMSDK.h>

2. 调用 registerWithOption: 方法初始化 SDK。

objc- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    ...
    //推荐在程序启动的时候初始化 NIMSDK    
    NSString *appKey        = @"your app key";//云信分配的 appKey
    NIMSDKOption *option    = [NIMSDKOption optionWithAppKey:appKey];
    option.apnsCername      = @"your APNs cer name";//APNs 推送证书名
    option.pkCername        = @"your pushkit cer name";//PushKit  推送证书名
    [[NIMSDK sharedSDK] registerWithOption:option];
    ...
}

以上提供了一个简化的初始化示例，更多初始化信息请参见初始化 SDK。

步骤3 引入呼叫组件

建议使用 CocoaPods 进行管理。呼叫组件内部没有引入 NERTC，请在 Podfile 中添加以下内容，单独引入 NERTC SDK 。

pod 'NERtcCallKit', '2.0.0'
pod 'NERtcSDK', '4.6.50', :subspecs => ['RtcBasic']    // subspecs => ['RtcBasic']用于指定使用RTC基础版本，不包含美颜功能。若要使用美颜功能，此行请修改为 pod 'NERtcSDK', '4.6.50'

SDK 版本限制：

• 呼叫组件与 NIM SDK、NERTC SDK 之间存在映射关系，使用呼叫组件时，必须使用指定版本的 NIM SDK 和 NERTC SDK。如果您在集成呼叫组件之前，已经集成了 NIM SDK 和 NERTC SDK，请确认 SDK 版本为指定版本。

• 不同版本的呼叫组件适配不同版本的 NIM SDK 和 NERTC SDK，具体版本的适配关系请参见更新日志。

步骤4 初始化呼叫组件

呼叫组件的实现为单实例，通过接口 NECallEngine.sharedInstance 获取此实例，调用实例方法 setup: 完成初始化。

setup: 方法为使用组件前必须调用的方法，若未初始化直接调用其他组件方法，会发生不可预知的问题或故障。

objc#import <NERtcCallKit/NERtcCallKit.h>

@interface SomeViewController()<NECallEngineDelegate>

@end

@implementation SomeViewController

- (void)viewDidLoad {
    [self setupSDK];
}

- (void)setupSDK {
    NESetupConfig *setupConfig = [[NESetupConfig alloc] initWithAppkey:kAppKey];
    [[NECallEngine sharedInstance] setup:setupConfig];
    
    NECallUIKitConfig *config = [[NECallUIKitConfig alloc] init];
    [[NERtcCallUIKit sharedInstance] setupWithConfig:config];
}

@end

步骤5 登录和登出 IM

若已经在 App 内实现了 NIMSDK 登录和登出逻辑，则不必调用相应的登录、登出接口，直接跳过此步骤即可。

使用组件的 NIMSDK login 进行登录，使用 NIMSDK logout 进行登出，登出或未进行登录则不能进行呼叫。

objective-c[NIMSDK.sharedSDK.loginManager login:@"accid" token:@"token" completion:^(NSError * _Nullable error) {
        
}];

[NIMSDK.sharedSDK.loginManager logout:^(NSError * _Nullable error) {
            
}];

实现 1 对 1 呼叫

呼叫组件（NERTCCallkit）内部已包括了呼叫的相关逻辑，您只需要调用几行代码触发呼叫即可。

objcNEUICallParam *callParam = [[NEUICallParam alloc] init];
NEUser *localUser = [NEAccount shared].userModel;
callParam.currentUserAccid = @"current user accid";
callParam.remoteUserAccid = @"remote Accid";
callParam.remoteShowName = @"remote show name";
[[NERtcCallUIKit sharedInstance] callWithParam:callParam withCallType:callType];