Android

最近更新时间:2024-09-06 17:59:21

我的收藏
TUIKit 组件从 4.8.50 版本开始支持音视频通话功能,并且实现了 iOS、 Android、Web 平台的互通。
说明:
在 6.5.xxxx 版本以后,TUIKit 组件升级了音视频通话功能,采用了全新的 TUICallKit,新版本音视频通话功能需要加购专属的 IM 音视频通话能力包后解锁,具体购买方法请参见 步骤1:开通音视频服务,如已开通,则可忽略该步骤。
需要注意的是不同的版本在集成方式上有一定的区别,详见 版本说明建议升级到 6.5.2816 及以上版本,本文重点讲解 6.5.2816 及以上版本的集成方案。
音视频通话界面如下图所示:
单人通话
群组通话







步骤1:开通服务

在使用腾讯云提供的音视频服务前,您需要前往控制台,为应用开通音视频服务。具体步骤请参见 开通服务。

步骤2:配置工程文件

APPbuild.gradle 文件中添加对 tuicallkit 的依赖:
api project(':tuicallkit-kt')

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

TUICallKit 组件和 TUIChat 组件可自由组合,当集成了 TUICallKit 组件后,TUIChat 会默认开启音视频通话功能,并在聊天页面更多菜单中显示入口。
如果您想在 TUIChat 中动态的打开/关闭视频或语音通话入口,可以调用如下代码进行控制。示例代码如下:
private void initViews() {
// 开启语音通话入口
TUIChatConfigs.getConfigs().getGeneralConfig().setEnableVoiceCall(true);
// 开启视频通话入口
TUIChatConfigs.getConfigs().getGeneralConfig().setEnableVideoCall(true);
...
}


步骤4:离线推送

在使用离线推送之前,您需要开通 IM 离线推送 服务。IM 为您提供了两种集成方式:
TIMPush 推送插件(推荐)
两种集成方式均支持小米、华为、荣耀、OPPO、vivo、魅族、APNs、一加、realme、iQOO、 FCM 等厂商通道。我们推荐接入 TIMPush 推送插件,该插件接入更简单,支持数据统计和链路追踪,且有更高的可触达范围。具体详情请见:推送功能介绍
按照上述 TIMPush 推送插件文档配置完成后,会接收到“音视频通话离线推送通知”,首先会打开您配置的 App 跳转页面,然后 TUICallKit 会自动拉起“音视频通话邀请界面”,集成 TIMPush 推送插件 的效果如下(以下是vivo X60的显示效果,不同厂商的设备可能会呈现出不同的效果)。
应用在后台时或离线时
锁屏时







版本说明

版本
库/组件名称
说明
4.8.50 ~ 5.1.60
TUIKit
TUIKit 组件默认集成了音视频通话 UI 组件和 TRTC 音视频库
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 及以上
全新升级音视频通话组件,功能更强大

更多特性

悬浮窗

常见问题

如果您的接入和使用中遇到问题,请参见 常见问题

交流与反馈

如果您在使用过程中,有什么建议或者意见,可以在这里反馈:TUICallKit 产品反馈问卷,感谢您的反馈。
如果您是开发者,也欢迎您加入我们的 TUICallKit 技术交流 QQ 群:605115878,进行技术交流和产品沟通。