腾讯云即时通信IMiOS_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:集成 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 会自动拉起「音视频通话邀请界面」。
版本说明
版本 | 库/组件名称 | 说明 |
4.8.50 ~ 5.1.60 | TXIMSDK_TUIKit_iOS | TUIKit 组件默认集成了音视频通话 UI 组件和 TRTC 音视频库 |
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 及以上版本 | TUICallKit | 全新升级音视频通话组件,功能更强大 |
常见问题
错误提示“The package you purchased does not support this ability”?
如遇以上错误提示,是由于您当前应用的音视频通话能力包过期或未开通,请参见 步骤一:开通服务,领取或者开通音视频通话能力,进而继续使用 TUICallKit 组件.
如何购买套餐?
请参考购买链接:音视频通话 SDK 购买指南,如有其他问题,请点击页面右侧,进行售前套餐咨询,或者加入 下方 QQ 群 进行咨询和反馈。
在邀请超时时间内,被邀请者如果离线再上线,能否立即收到邀请?
如果是单聊通话邀请,被邀请者离线再上线可以收到通话邀请,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 群进行技术交流和反馈问题。
开源建设
您可以在 这里 找到升级前的 TUICalling 开源项目。
对即时通讯IM解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?