TUIKit 组件从 4.8.50 版本开始支持音视频通话功能,并且实现了 iOS、 Android、Web 平台的互通。
说明:
在 6.5.xxxx 版本以后,TUIKit 组件升级了音视频通话功能,采用了全新的 TUICallKit,新版本音视频通话功能需要加购专属的 IM 音视频通话能力包后解锁,具体购买方法请参考 步骤1:开通音视频服务,如已开通,则可忽略该步骤。 需要注意的是不同的版本在集成方式上有一定的区别,详见 版本说明。建议升级到 6.5.2816 及以上版本,本文重点讲解 6.5.2816 及以上版本的集成方案。 音视频通话界面如下图所示:
|
![](https://qcloudimg.tencent-cloud.cn/raw/83d6cd991cd0e9251caafebe75e46f12.png) | ![](https://qcloudimg.tencent-cloud.cn/raw/842c563a9dd99da4950402e7a61836dd.png) |
步骤1:开通音视频通话服务
2. 在页面的右下角找到腾讯实时音视频服务功能区,单击下方 音视频通话能力-免费体验 ,在弹出的免费开通音视频通话能力体验版对话框中,单击免费开通,即可开通 TUICallKit 的 60 天免费试用服务。
步骤2:集成 TUICallKit 组件
2. 执行以下命令,下载第三方库至当前工程。
如果无法安装 TUIKit 最新版本,执行以下命令更新本地的 CocoaPods 仓库列表。
步骤3:打开/关闭音视频通话
TUICallKit 组件和 TUIChat 组件可自由组合,当集成了 TUICallKit 组件后,TUIChat 会默认开启音视频通话功能,并在聊天页面更多菜单中显示入口。
如果您想在 TUIChat 中动态地打开/关闭视频或语音通话入口,可以在进入聊天界面之前,配置 TUIChatConfig
中的 enableVideoCall
和 enableAudioCall
。
示例代码如下:
[TUIChatConfig defaultConfig].enableVideoCall = NO; // YES:开启,NO:关闭
[TUIChatConfig defaultConfig].enableAudioCall = NO; // YES:开启,NO:关闭
步骤4:离线推送
配置完成后,当单击接收到的「音视频通话离线推送通知」时, TUICallKit 会自动拉起「音视频通话邀请界面」。
版本说明
|
| | TUIKit 组件默认集成了音视频通话 UI 组件和 TRTC 音视频库 |
| | - TUIKit 组件默认不再集成音视频通话 UI 组件和 TRTC 音视频库 <br/>- 音视频相关逻辑都移到了 TXIMSDK_TUIKit_live_iOS 组件里面 |
| | TUICalling 组件包含了所有的音视频通话 UI 和 TRTC 音视频库 <br/>TUICalling 组件支持与 TUIKit 其他组件自由组合 |
| | |
| | |
常见问题
错误提示“The package you purchased does not support this ability”?
如遇以上错误提示,是由于您当前应用的音视频通话能力包过期或未开通,请参见 步骤一:开通服务,领取或者开通音视频通话能力,进而继续使用 TUICallKit 组件. 如何购买套餐?
音视频通话 SDK 目前处于内测期,提供有效期为60天的免费体验版。
在邀请超时时间内,被邀请者如果离线再上线,能否立即收到邀请?
如果是单聊通话邀请,被邀请者离线再上线可以收到通话邀请,TUIKit 内部会自动唤起通话邀请界面。
如果是群聊通话邀请,被邀请者离线再上线后会自动拉取最近 20 条邀请,TUICallKit 会自动唤起群通话界面。
TUICallKit 和自己集成的音视频库冲突了?
腾讯云的 音视频库 不能同时集成,可能产生符号冲突,可以按照下面的场景处理。 如果您使用了 TXLiteAVSDK_TRTC
库,不会发生符号冲突。可直接在 Podfile 文件中添加依赖,
如果您使用了 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 最后的一个稳定的 cocoapods 版本号为:9.6.4,如果您使用的是 cocoapods 集成,直接升级 IM 相关组件版本号即可。如果您是手动集成,也只需要替换 IM 相关组件的源代码即可。
TUICalling 和 TUICallKit 可以自由互通,建议您升级到最新的 TUICallKit 组件。
开源建设
您可以在 这里 找到升级前的 TUICalling 开源项目。
本页内容是否解决了您的问题?