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:配置工程文件
在
APP
的 build.gradle
文件中添加对 tuicallkit
的依赖:api project(':tuicallkit')
步骤3:打开/关闭音视频通话
TUICallKit 组件和 TUIChat 组件可自由组合,当集成了 TUICallKit 组件后,TUIChat 会默认开启音视频通话功能,并在聊天页面更多菜单中显示入口。
如果您想在 TUIChat 中动态的打开/关闭视频或语音通话入口,可以调用如下代码进行控制。示例代码如下:
private void initViews() {// 开启语音通话入口TUIChatConfigs.getConfigs().getGeneralConfig().setEnableVoiceCall(true);// 开启视频通话入口TUIChatConfigs.getConfigs().getGeneralConfig().setEnableVideoCall(true);...}
步骤4:离线推送
在使用离线推送之前,您需要开通 IM 离线推送 服务。关于 APP 的配置,您也可以直接使用 TUIOfflinePush 组件快速接入厂商推送,完成后,接收端就可以收到如下图所示的推送通知,单击该通知,可以拉起应用,并跳转到通话邀请界面。
说明
配置完成后,单击接收到的“音视频通话离线推送通知”时,首先会打开您配置的 APP 跳转页面,然后 TUICallKit 会自动拉起“音视频通话邀请界面”
版本说明
版本 | 库/组件名称 | 说明 |
4.8.50 ~ 5.1.60 | TUIKit | |
5.4.666 ~ 5.6.1200 | TUIKitLive | TUIKit 组件默认不再集成音视频通话 UI 组件和 TRTC 音视频库 音视频相关逻辑都移到了 TUIKitLive 组件里面 |
5.7.1435 - 6.0.1992 | TUICalling | TUICalling 组件包含了所有的音视频通话 UI 和 TRTC 音视频库 TUICalling 组件支持与 TUIKit 其他组件自由组合 |
6.1.2155 - 6.5.2803 | TUICalling | TUICalling 前后台切换体验优化 |
6.5.2816 及以上 | 全新升级音视频通话组件,功能更强大 |
常见问题
错误提示“The package you purchased does not support this ability”?
如何购买套餐?
在通话邀请超时时间内,被邀请者如果离线再上线,能否弹出通话界面?
根据 App 的启动类型,分别有不同的情况:


说明
单击离线推送通知,拉不起通话界面
1. 首先,请检查配置的离线推送的跳转逻辑,确保可以拉取 App 主界面。
2. 检查音视频通话界面
BaseCallActivity
是否被遮挡,如果被遮挡,请调整Activity的启动模式或启动顺序。说明
例如,在 App 中配置的 intent 需要与小米推送控制台上的一致。


<activityandroid:name="应用包名.MainActivity"android:launchMode="singleTask"android:screenOrientation="portrait"><intent-filter><action android:name="android.intent.action.VIEW" /><category android:name="android.intent.category.DEFAULT" /><dataandroid:host="com.tencent.qcloud"android:path="/detail"android:scheme="pushscheme" /></intent-filter></activity>
应用在后台时,不能自动将通话界面拉取到前台
将应用从后台自动拉取到前台,需要检查 App 是否开启了”后台自启动“或”悬浮窗“权限。
值得注意的是,不同厂商、甚至同一厂商不同 Android 版本,其对于应用开放的权限以及权限名称也会存在不一致。例如,小米6只需要开启后台弹出界面权限,而红米需要同时打开后台弹出界面和显示悬浮窗权限。
说明
OPPO手机权限位置 | 小米手机权限位置 |
![]() | ![]() |
如果您使用的是老版本 TUICalling,想单独升级 IM 相关组件(TUIChat/TUIConversation/TUIGroup/TUIContact/TUISearch/TUIOfflinePush),应该怎么处理?
只需要替换 IM 相关组件的源代码即可。TUICalling 和 TUICallKit 可以自由互通,建议您升级到最新的 TUICallKit 组件。
交流与反馈
欢迎加入 QQ 群进行技术交流和反馈问题。

