tencent cloud

TUIKit 组件从 4.8.50 版本开始支持音视频通话功能，并且实现了 iOS、 Android、Web 平台的互通。

说明：

• 在 6.5.xxxx 版本以后，TUIKit 组件升级了音视频通话功能，采用了全新的 TUICallKit，新版本音视频通话功能需要加购专属的 IM 音视频通话能力包后解锁，具体购买方法请参考 步骤1：开通音视频服务，如已开通，则可忽略该步骤。
• 需要注意的是不同的版本在集成方式上有一定的区别，详见 版本说明。建议升级到 6.5.2816 及以上版本，本文重点讲解 6.5.2816 及以上版本的集成方案。

音视频通话界面如下图所示：

视频通话	语音通话

步骤1：开通音视频通话服务

1. 登录 即时通信 IM 控制台 ，单击目标应用卡片，进入应用的基础配置页面。

2. 在页面的右下角找到腾讯实时音视频服务功能区，单击下方 音视频通话能力-免费体验 ，在弹出的免费开通音视频通话能力体验版对话框中，单击免费开通，即可开通 TUICallKit 的 60 天免费试用服务。

步骤2：集成 TUICallKit 组件

1. 在 podfile 文件中添加以下内容。

   // 集成音视频通话组件
   pod 'TUICallKit'                  
   

2. 执行以下命令，下载第三方库至当前工程。

   pod install
   

   如果无法安装 TUIKit 最新版本，执行以下命令更新本地的 CocoaPods 仓库列表。

   pod repo update
   

步骤3：打开/关闭音视频通话

TUICallKit 组件和 TUIChat 组件可自由组合，当集成了 TUICallKit 组件后，TUIChat 会默认开启音视频通话功能，并在聊天页面更多菜单中显示入口。

如果您想在 TUIChat 中动态地打开/关闭视频或语音通话入口，可以在进入聊天界面之前，配置 TUIChatConfig 中的 enableVideoCall 和 enableAudioCall。
示例代码如下：

[TUIChatConfig defaultConfig].enableVideoCall = NO; // YES：开启，NO：关闭
[TUIChatConfig defaultConfig].enableAudioCall = NO; // YES：开启，NO：关闭

步骤4：离线推送

在使用离线推送之前，您需要开通 IM 离线推送 服务。关于 APP 的配置，您也可以 集成 TUIOfflinePush 跑通离线推送功能。

配置完成后，当单击接收到的「音视频通话离线推送通知」时， TUICallKit 会自动拉起「音视频通话邀请界面」。

版本说明

常见问题

错误提示“The package you purchased does not support this ability”？

如遇以上错误提示，是由于您当前应用的音视频通话能力包过期或未开通，请参见 步骤一：开通服务，领取或者开通音视频通话能力，进而继续使用 TUICallKit 组件.

如何购买套餐？

音视频通话 SDK 目前处于内测期，提供有效期为60天的免费体验版。

在邀请超时时间内，被邀请者如果离线再上线，能否立即收到邀请？

• 如果是单聊通话邀请，被邀请者离线再上线可以收到通话邀请，TUIKit 内部会自动唤起通话邀请界面。
• 如果是群聊通话邀请，被邀请者离线再上线后会自动拉取最近 20 条邀请，TUICallKit 会自动唤起群通话界面。

TUICallKit 和自己集成的音视频库冲突了？

腾讯云的 音视频库 不能同时集成，可能产生符号冲突，可以按照下面的场景处理。

• 如果您使用了 TXLiteAVSDK_TRTC 库，不会发生符号冲突。可直接在 Podfile 文件中添加依赖，

  pod 'TUICallKit'
  

• 如果您使用了 TXLiteAVSDK_Professional 库，会产生符号冲突。您可在 Podfile 文件中添加依赖，

  pod 'TUICallKit/Professional'
  

• 如果您使用了 TXLiteAVSDK_Enterprise 库，会产生符号冲突。建议升级到 TXLiteAVSDK_Professional 后使用 TUICallKit/Professional。

集成 TUICallKit 后运行报错 “ld: framework not found BoringSSL clang: error: linker command failed with exit code 1 sdk”

由于 TUICallKit 所依赖的音视频库暂不支持模拟器，请用真机运行或者调试。

如果您使用的是老版本 TUICalling，想单独升级 IM 相关组件（TUIChat/TUIConversation/TUIGroup/TUIContact/TUISearch/TUIOfflinePush），应该怎么处理？

TUICalling 最后的一个稳定的 cocoapods 版本号为：9.6.4，如果您使用的是 cocoapods 集成，直接升级 IM 相关组件版本号即可。如果您是手动集成，也只需要替换 IM 相关组件的源代码即可。

TUICalling 和 TUICallKit 可以自由互通，建议您升级到最新的 TUICallKit 组件。

开源建设

您可以在 这里 找到升级前的 TUICalling 开源项目。