腾讯云即时通信IMAndroid_AI解决方案_同尘科技

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 会自动拉起“音视频通话邀请界面”

版本说明

常见问题

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

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

如何购买套餐？

请参考购买链接：音视频通话 SDK 购买指南，如有其他问题，请单击页面右侧，进行售前套餐咨询，或者加入下方 QQ 群进行咨询和反馈。

在通话邀请超时时间内，被邀请者如果离线再上线，能否弹出通话界面？

根据 App 的启动类型，分别有不同的情况：
说明如果离线再上线后没有弹出通话界面，请过滤 “onReceiveNewInvitation”日志，检查是否拉取到历史消息，如果没有该日志的打印，请加入 下方 QQ 群 联系我们协助处理。

单击离线推送通知，拉不起通话界面

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

应用在后台时，不能自动将通话界面拉取到前台

将应用从后台自动拉取到前台，需要检查 App 是否开启了”后台自启动“或”悬浮窗“权限。值得注意的是，不同厂商、甚至同一厂商不同 Android 版本，其对于应用开放的权限以及权限名称也会存在不一致。例如，小米6只需要开启后台弹出界面权限，而红米需要同时打开后台弹出界面和显示悬浮窗权限。说明 如果您在测试过程中发现手动开启了所有权限，依然无法自动拉起通话界面到前台，需要做兼容处理。可以加入下方 QQ 群联系我们协助处理。

OPPO手机权限位置	小米手机权限位置
	

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

只需要替换 IM 相关组件的源代码即可。TUICalling 和 TUICallKit 可以自由互通，建议您升级到最新的 TUICallKit 组件。

交流与反馈

欢迎加入 QQ 群进行技术交流和反馈问题。


对即时通讯IM解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案