TUIKit 组件从 4.8.50 版本开始支持音视频通话功能,并且实现了 iOS、 Android、Web 平台的互通。
说明
在 6.5.xxxx 版本以后,TUIKit 组件升级了音视频通话功能,采用了全新的 TUICallKit,新版本音视频通话功能需要加购专属的 IM 音视频通话能力包后解锁,具体购买方法请参考 步骤1:开通音视频服务,如已开通,则可忽略该步骤。
需要注意的是不同的版本在集成方式上有一定的区别,详见 版本说明。建议升级到 6.5.2816 及以上版本,本文重点讲解 6.5.2816 及以上版本的集成方案。
音视频通话界面如下图所示:
视频通话 | 语音通话 |
![]() | ![]() |
步骤1:开通音视频通话能力
1. 登录 即时通信 IM 控制台 ,单击目标应用卡片,进入应用的基础配置页面。
2. 在页面的右下角找到开通腾讯实时音视频服务功能区。
2.1 若您需要体验音视频通话功能,可单击卡片内的 免费体验 开通 TUICallKit 的 7 天免费试用服务。


2.2 您可参见 音视频通话能力版本说明 确认所需要使用的版本,单击 购买正式版 以购买正式的音视频通话能力。在购买页内的增值服务中勾选“音视频通话能力”,并选择所需版本即可。



步骤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:离线推送
配置完成后,当单击接收到的「音视频通话离线推送通知」时, TUICallKit 会自动拉起「音视频通话邀请界面」。
版本说明
版本 | 库/组件名称 | 说明 |
4.8.50 ~ 5.1.60 | TXIMSDK_TUIKit_iOS | |
5.4.666 ~ 5.6.1200 | TXIMSDK_TUIKit_live_iOS | TUIKit 组件默认不再集成音视频通话 UI 组件和 TRTC 音视频库 音视频相关逻辑都移到了 TXIMSDK_TUIKit_live_iOS 组件里面 |
5.7.1435 ~ 6.0.1992 | TUICalling | TUICalling 组件包含了所有的音视频通话 UI 和 TRTC 音视频库 TUICalling 组件支持与 TUIKit 其他组件自由组合 |
6.1.2155 及以上 | TUICalling | TUICalling 前后台切换体验优化 |
6.5 及以上版本 | 全新升级音视频通话组件,功能更强大 |
常见问题
错误提示“The package you purchased does not support this ability”?
如何购买套餐?
在邀请超时时间内,被邀请者如果离线再上线,能否立即收到邀请?
如果是单聊通话邀请,被邀请者离线再上线可以收到通话邀请,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 组件。
交流与反馈
欢迎加入 QQ 群进行技术交流和反馈问题。