自 IM UIKit v9.4.0 开始，会话消息模块（NEChatUIKit）支持音视频通话功能。该功能基于云信呼叫组件实现。

本文介绍如何在 IM UIKit 中引入和初始化呼叫组件，进而在您的 IM 应用中实现音视频通话。

功能介绍

实现音视频通话功能后，用户在会话界面的输入区域点击 > ，即可快速发起音频通话或视频通话。

开发环境

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

前提条件

• 已开通 IM 即时通讯、音视频通话 2.0、音视频通话2.0-话单以及信令能力。开通服务的操作流程请参考开通能力。

• 已集成会话消息界面。

实现流程

步骤 1：引入呼叫组件

1. 在 Podfile 文件中引入呼叫组件。

   platform :ios, '10.0'
   
   target 'your project name' do
   # Comment the next line if you don't want to use dynamic frameworks
       use_frameworks!
       pod 'NERtcCallUIKit', '1.8.2'  
       pod 'NERtcCallKit', '1.8.2'
       pod 'NERtcSDK', '4.6.29'
   end
   

2. 执行 pod install 命令导入组件。

步骤2：初始化呼叫组件

对于不同的呼叫 UI 组件版本，初始化接口不同。

使用低于 2.1.0 版本的呼叫 UI 组件

在发起音视频通话前，需先调用 setup 方法初始化呼叫组件。

示例代码：

//呼叫组件初始化
let option = NERtcCallOptions()
option.apnsCerName = "your cer name"
let uiConfig = NERtcCallUIConfig()
uiConfig.option = option
uiConfig.appKey = "your appkey"
uiConfig.uiConfig.showCallingSwitchCallType = option.supportAutoJoinWhenCalled
NERtcCallKit.sharedInstance().timeOutSeconds = 30
NERtcCallUIKit.sharedInstance().setup(with: uiConfig)

//呼叫组件初始化
NERtcCallOptions *option = [[NERtcCallOptions alloc] init];
option.APNSCerName = @"your cer name";
NERtcCallUIConfig *uiConfig = [[NERtcCallUIConfig alloc] init];
uiConfig.option = option;
uiConfig.appKey = @"your appkey";
uiConfig.uiConfig.showCallingSwitchCallType = option.supportAutoJoinWhenCalled;
NERtcCallKit.sharedInstance.timeOutSeconds = 30;
[NERtcCallUIKit.sharedInstance setupWithConfig:uiConfig];

使用 2.1.0 及以上版本的呼叫 UI 组件

在发起音视频通话前，需先调用 setup 方法初始化呼叫组件。

示例代码：

//呼叫组件初始化
let setup = NESetupConfig(appkey:  "your app key")
NECallEngine.sharedInstance().setTimeout(30)
let uiConfig = NECallUIKitConfig()
uiConfig.config = setup
uiConfig.appKey =  "your app key"
NERtcCallUIKit.sharedInstance().setup(with: uiConfig)

//呼叫组件初始化
NESetupConfig *setupConfig = [[NESetupConfig alloc] initWithAppkey:@"your app key"];
NECallUIKitConfig *config = [[NECallUIKitConfig alloc] init];
config.config = setupConfig;
config.appKey =  @"your app key";
[[NECallEngine sharedInstance] setTimeout:30];
[[NERtcCallUIKit sharedInstance] setupWithConfig:config];

步骤3：发起音视频通话

呼叫组件里，音频通话和视频通话的能力已被注册到路由中。因此您可调用 use 方法通过路由跳转至呼叫界面发起音视频通话。

方法原型（Swift）如下：

swiftpublic func use(_ url: String,
                parameters: [String: Any]? = nil,
                closure: RouteHandleCallbackClosure? = nil)

其中呼叫页面的 parameters 包括以下子参数：

示例代码（Swift）如下：

var param = [String: AnyObject]()
param["remoteUserAccid"] = "callee accid" 
param["currentUserAccid"] = NIMSDK.shared().loginManager.currentAccount() 
param["remoteShowName"] = "callee name" 
param["remoteAvatar"] = "callee avatar" //选填
param["type"] = NSNumber(integerLiteral: 1) as AnyObject // 呼叫类型，1为音频，2为视频
Router.shared.use("imkit://callkit.page", parameters: param)

相关信息

其他功能开通

如果需要实现“屏蔽黑名单用户发起的语音/视频通话请求”，需要在云信控制台开启该功能。 如未开通该功能，黑名单用户仍可以向将其拉黑的用户发起通话请求。

1. 在控制台首页应用管理选择应用进入应用配置页面，然后单击 IM即时通讯 专业版下的功能配置按钮进入 IM 即时通讯配置页。

   

2. 在顶部选择基础功能页签，开启被拉黑时被拉黑者无法唤起呼叫。

   

错误码

呼叫组件相关错误码，请参见错误码。

常见问题

集成组件后出现编译错误

更多问题

更多问题，请参见呼叫组件常见问题。