tencent cloud

实时音视频

动态与公告
产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
产品简介
产品概述
基本概念
产品功能
产品优势
应用场景
性能数据
购买指南
计费概述
免费时长说明
月订阅
现收现付
TRTC 逾期与暂停政策
常见问题解答
退款说明
新手指引
Demo 体验
视频通话 SDK
组件介绍
开通服务
跑通 Demo
快速接入
离线唤醒
会话聊天
云端录制
AI 降噪
界面定制
Chat 集成通话能力
更多特性
无 UI 集成
服务端 API
客户端 API
解决方案
错误码表
发布日志
常见问题
视频会议 SDK
组件介绍(TUIRoomKit)
开通服务(TUIRoomKit)
跑通 Demo(TUIRoomKit)
快速接入(TUIRoomKit)
屏幕共享(TUIRoomKit)
预定会议(TUIRoomKit)
会中呼叫(TUIRoomKit)
界面定制(TUIRoomKit)
虚拟背景(TUIRoomKit)
会议控制(TUIRoomKit)
云端录制(TUIRoomKit)
AI 降噪(TUIRoomKit)
会中聊天(TUIRoomKit)
机器人推流(TUIRoomKit)
更多特性(TUIRoomKit)
客户端 API(TUIRoomKit)
服务端 API(TUIRoomKit)
常见问题(TUIRoomKit)
错误码 (TUIRoomKit)
SDK更新日志(TUIRoomKit)
直播与语聊 SDK
Live 视频直播计费说明
组件介绍
开通服务(TUILiveKit)
跑通 Demo
无 UI 集成
UI 自定义
直播监播
视频直播
语聊房
高级功能
客户端 API
服务端 API
错误码
发布日志
常见问题
RTC Engine
开通服务
SDK 下载
API-Example
接入指引
API-参考手册
高级功能
AI 集成
概述
MCP 配置
Skills 配置
集成指南
常见问题
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
控制台指南
应用管理
套餐包管理
用量统计
监控仪表盘
开发辅助
解决方案
实时合唱
常见问题
迁移指南
计费相关
功能相关
UserSig 相关
应对防火墙限制相关
缩减安装包体积相关
Andriod 与 iOS 相关
Web 端相关
Flutter 相关
Electron 相关
TRTCCalling Web 相关
音视频质量相关
其他问题
旧版文档
RTC RoomEngine SDK(旧)
集成 TUIRoom (Web)
集成 TUIRoom (Android)
集成 TUIRoom (iOS)
集成 TUIRoom (Flutter)
集成 TUIRoom (Electron)
TUIRoom API 查询
实现云端录制与回放(旧)
监控仪表盘计费(旧)
协议与策略
安全合规认证
安全白皮书
信息安全说明
服务等级协议
苹果隐私策略:PrivacyInfo.xcprivacy
TRTC 政策
隐私协议
数据处理和安全协议
词汇表

Android&iOS

PDF
聚焦模式
字号
最后更新时间: 2025-09-15 21:39:40
新版本(2.9.0.1230)涉及 TUICallEngine 接口变更:
如果您在开发过程中,更新 Android 代码到最新后,出现编译错误,可以使用如下方式解决:
替换 "com.tencent.qcloud.tuikit.tuicallengine" 为 "com.tencent.cloud.tuikit.engine.call"。
替换 "com.tencent.qcloud.tuikit.TUICommonDefine" 为 "com.tencent.cloud.tuikit.engine.common.TUICommonDefine"。
升级后的文件名没有变化,如还有其他文件报错,请自行重新导入。
如果您在开发过程中,因为执行 pod update 升级后,出现编译错误,可以使用如下方式解决:
替换 "import TUICallEngine" 为 "import RTCRoomEngine"。
对于需要升级到 calls 接口的用户,请您注意版本灰度,使用 calls 接口呼叫,如果对方的版本未升级,会导致通话失败。

Version 3.3.0.1081 @ 2025.08.25

新特性

Android/iOS 平台支持设置无痕通话模式。

缺陷修复

修复 设置昵称或头像接口导致 IM 用户自定义信息被修改的异常问题。
修复 被叫端点击接听的同时主叫端挂断,存在的 UI 异常问题。
修复 推送设置小米 channel_id 不生效问题。
修复 视频通话被叫拒绝后相机未关闭问题。
修复 用户接听后因心跳超时未能及时移除其 UI 视图的问题。

功能优化

Android 平台优化构造与销毁流程,杜绝异步和多线程潜在异常,提升稳定性。
iOS 平台优化线程管理及对象销毁流程,提升稳定性。

Version 3.2.0.835 @ 2025.07.16

新特性

Android & iOS:TUIOfflinePushInfo 新增多项控制字段,提升离线推送的灵活性和可控性。
Android & iOS:TUICallEvent 部分回调接口增加了必要的信息,便于开发者获取更全面的通话事件数据。
Android & iOS:TUICallEvent 新增 onUserInviting 和 onCallNotConnected 回调,建议使用 onCallNotConnected 替代原有的 onCallCancelled 回调。

缺陷修复

Android & iOS:修复了中途加入通话场景下的异常问题,进一步提升了加入通话流程的稳定性。

功能优化

Android & iOS:优化了通话异常挂断后无法再次发起或接收通话的问题,提升了通话的连续性体验。
Android & iOS:改善了弱网环境下通话成员恢复后可能导致的通话状态异常问题,增强了弱网下的通话稳定性。
Android & iOS:优化了 Chat 与 Call 融合使用时的整体体验,提升了产品的协同能力。

Version 3.1.0.824 @ 2025.06.12

缺陷修复

Android/iOS:修复中途加入场景下的异常问题,加入通话流程更稳定。

功能优化

全平台:优化通话异常挂断后,无法再次发起或接收通话的体验问题。
全平台:优化在弱网环境下,通话成员再恢复导致的通话状态异常问题。
全平台:优化 Chat 与 Call 融合使用时的体验问题。
iOS:优化 APNs 离线唤醒能力,支持持续震动和响铃,提升通话接听率。

Version 3.0.0.690 @ 2025.04.02

缺陷修复

全平台 :修复被叫端接听后,主叫端无法正常显示被叫视频画面的异常问题。
全平台 :修复通话超时时间不超过30秒的限制问题。
iOS :修复 iOS 设备无法设置视频分辨率的问题。

功能优化

全平台 :新增 onUserInviting 回调接口(用户被追加邀请加入通话场景),主动加入场景更完善,体验更好。
全平台 :优化 TUICallObserver 回调机制,参数及事件分类更清晰,易理解,使用更便捷。
全平台 :视频通话默认分辨率调整为720P,视频通话体验更好,更清晰。
Android/iOS :升级至全新 UIKit 架构,业务逻辑更清晰,更方便的实现 UI 定制。

Version 2.9.0.1230 @ 2025.2.18

新特性

Android&iOS:新增 calls 接口,支持发起单人通话或多人通话,更加灵活的通话成员管理,支持更强大的 REST API,欢迎使用。
Android&iOS:新增 join 接口,配合 calls 接口、支持加入已有通话。
Android&iOS:支持来电震动。

Version 2.7.0.1130 @ 2024.11.27

新特性

Android&iOS:新增繁体中文,优化使用体验。

缺陷修复

Android:修复收到FCM推送消息无法弹出通知的问题。
Android:修复中途加入语音通话,无法拉取已开摄像头的用户的画面问题。
iOS: 修复iOS主叫在接听前进入悬浮窗,接听后对端画面异常的问题。
iOS: 修复在等待接听页面关闭摄像头以后,接听后摄像头状态不一致的问题。

Version 2.6.0.1080 @ 2024.9.29

功能优化

Android:大屏设备支持横屏布局,增强使用体验。
iOS:适配 iOS 16以上的版本,支持应用外悬浮窗。
Android:有悬浮窗权限时,支持应用外悬浮窗。

缺陷修复

Android&iOS:修复极少场景下,发起通话后无回调问题。
Android&iOS:修复 hangup 接口回调两次问题。
iOS:修复 VoIP 使用过程中,切换音频播放设备不可用问题。
iOS:修复后台活跃状态收到来电后,进入 APP 后铃声不响问题。

Version 2.5.0.1025 @ 2024.8.7

功能优化

Android:优化中途加入的逻辑,避免内存泄露。

缺陷修复

Android&iOS:修复发送群通话邀请给 web 端用户,web 用户收不到通话邀请的问题。
Android:修复群组通话中 A 语音呼叫 B,B 收到推送通知后点击拉起界面,显示是扬声器而不是听筒问题。

Version 2.4.0.970 @ 2024.6.11

功能优化

Android&iOS:弱网时提示用户,增强用户使用体验。
Android:优化被叫端锁屏时的来电策略。
iOS:修复群通话内存异常增长问题。

缺陷修复

Android&iOS:修复主动加入通话界面显示异常问题。

Version 2.3.0.915 @ 2024.4.15

功能优化

Android&iOS:支持在 TUIChat 的群组顶部显示通话状态,并允许群成员主动加入通话。
Android&iOS:优化来电弹出逻辑,默认展示横幅接听框。
Android&iOS:视频通话支持背景虚化。

缺陷修复

Android:修复通话记录编辑界面中,点击删除按钮无响应的问题。
iOS:修复在群通话中点击成员视图时,切换过程中出现重影的问题 。
iOS:修复音视频界面特定场景下不显示的问题。
Android&iOS:修复在呼叫忙线中的用户时,通话结束后缺少提示的问题。

Version 2.2.0.860 @ 2024.2.1

功能优化

Android&iOS:全新的UI视效,功能更清晰,体验更好。

缺陷修复

Android&iOS:修复在会议、直播场景下,接听来电后,麦克风和摄像头设备互相占用问题。

Version 2.1.0.810 @ 2023.12.19

功能优化

Android:优化未登录时调用 TUICallKit 接口异常的提示。
Android: 优化针对 Android 14平台(API 34) 的兼容性,详见:Android 14 行为变更
Android&iOS:优化用户昵称的显示,按照如下顺序显示:用户备注 > 用户昵称 > 用户 Id,默认为 userId。

缺陷修复

iOS:修复群通话头像显示重叠问题。
iOS:修复视频通话时开启悬浮窗发消息再回到通话界面键盘无法收起问题。
iOS:修复视频通话中,先切换摄像头、关闭摄像头,再切换回原摄像头并重新打开时,无法切换和移动摄像头的问题。
Android:修复在阿拉伯语等从右至左布局模式(RTL 模式)下单人视频通话的小窗口无法移动的问题。

Version 2.0.0.750 @ 2023.11.03

功能优化

Android&iOS:UIKit 支持日语。
Android&iOS:优化通话昵称显示。
Android&iOS:调整铃声的默认音量,由60%调整到100%。

缺陷修复

iOS:修复 Swift 版本加载图片过慢问题。
iOS:修复主叫端发起通话后退后台,通话邀请自动取消问题。

Version 1.9.0.680 @ 2023.09.27

功能优化

Android&iOS:支持阿拉伯语言。
Android&iOS:优化套餐购买提示,支持根据链接跳转到对应的套餐购买页。
Android&iOS:优化不同分辨率下的默认码率,高分辨率下画面更清晰,详见 Resolution
Android&iOS:调整视频通话的默认码率为600kbps,美颜等级为4级。

缺陷修复

Android&iOS:对黑名单用户发起通话,通话拒绝提示与发送单聊消息拒绝提示不一致。
iOS:4人群视频通话界面,一名成员拒绝接听,发起人视频位置画面异常。
iOS:修复登录成功后立即设置美颜,分辨率会被重置问题。

Version 1.8.0.620 @ 2023.08.14

功能优化

Android&iOS:通话消息默认不计入未读数。
Android:优化小米手机悬浮窗权限跳转页面。

缺陷修复

iOS:修复被移下线后回调接口 onKickOffline 无效问题。
iOS: 修复通话记录未接界面清除通话后,回到所有通话界面,列表为空问题。

Version 1.7.2.570 @ 2023.07.20

功能优化

Android:默认关闭重力感应,优化在大屏、定制设备的通话体验。

缺陷修复

Android&iOS:A 呼叫 B(离线)后取消,A 再次呼叫 B,B 登录上线,B 的云端通话记录异常问题。
Android: 升级 TRTC SDK 版本到11.3后,TUICallKit 的崩溃问题。

Version 1.7.0.460 @ 2023.06.25

功能优化

Android&iOS:含 UI 集成方案,优化示例工程,完善通话设置项。
Android:降低通话时系统保活的级别,只在状态栏显示保活提示,去掉通知和震动。

Version 1.6.1.410 @ 2023.05.22

新特性

Android&iOS:含 UI 接口 callgroupCall 支持自定义房间号。
Android&iOS:支持发起通话时传入字符串型房间号,详见 CallParams

缺陷修复

Android:修复通过 Arrays.asList 方式生成列表参数时,groupCall 报错问题。
Android:修复视频通话显示异常问题。
iOS:修复与 TUIRoom 组件冲突问题。
iOS:修复登录成功回调中,立刻发起通话崩溃问题。
iOS:修复点击通知消息进入 APP,偶现不显示邀请页面问题。

Version 1.6.0.360 @ 2023.04.27

新特性

Android:TUICallKit 新增 Kotlin 语言版本;
iOS:TUICallKit 新增 Swift 语言版本;
Android&iOS:新增通话记录(本地)的显示页面。

功能优化

Android:优化单人视频通话头像显示;
Android&iOS:群组通话中,默认支持邀请其他群成员加入通话。

缺陷修复

Android:修复 Android 12及其以上 设备链接蓝牙后无声的问题;
Android:修复被叫端偶现静音设置不生效问题;
iOS:修复重新登录后偶现设备接收不到来电邀请的问题;
IOS:修复 TUICallKit 中 enableCustomViewRoute 接口失效问题;
IOS:修复 VoIP 推送页面昵称显示错误的问题。

Version 1.5.1.310 @ 2023.04.17

新特性

Android&iOS:新增 VoIP 消息推送功能,提供更好的通话接听体验。
Android&iOS:支持发起通话时自定义扩展字段,详见 call 方法的 TUICallDefine.CallParams 参数。

功能优化

Android&iOS:优化华为、小米、FCM 等厂商的离线推送能力,增加厂商消息分类及 channelID 设置。

缺陷修复

Android&iOS:修复 Chat 自定义属性发起通话后被覆盖的问题。
Android:修复回调 onCallEnd 中 totalTime 的时间单位错误的问题;

Version 1.5.0.305 @ 2023.03.09

功能优化

Android&iOS:优化上屏消息显示。
Android:贴耳息屏功能默认关闭。
Android:升级 gradle 插件及版本。
Android:优化铃声播放类,支持循环播放。

缺陷修复

Android&iOS:修复被叫接听通话失败,没有 onCallCancel 回调问题。
Android:修复被叫接听通话失败,主叫异常问题。
Android:修复首次通话检查权限时,主叫端取消通话,被叫端再次拉起界面问题。
Android:修复回调上层的网络质量 userId 为空问题。

Version 1.4.0.255 @ 2023.01.06

新特性

Android&iOS:支持自定义来电超时时间,详见 call方法 TUICallDefine.CallParams 参数。

缺陷修复

Android&iOS:修复主动加入房间(joinInGroupCall)时通话异常结束问题。
Android:修复在音视频通话接听中退后台,再回到前台时,通话状态异常问题。

Version 1.3.0.205 @ 2022.11.30

新特性:

Android&iOS:新增美颜设置接口 setBeautyLevel,支持关闭默认美颜。

功能优化:

iOS: 优化 TUICallKit 的 Framework 体积。

缺陷修复:

Android&iOS:修复服务端解散房间或踢出用户时,通话界面不消失问题。
Android:修复A呼叫离线用户B,然后取消;A 再次呼叫 B,B 上线后通话界面不显示问题。

Version 1.2.0.153 @ 2022.11.14

新特性:

Android&iOS:支持视频自定义编码分辨率。
Android&iOS:支持设置视频的渲染参数:渲染方向、填充模式。
Android&iOS:支持第三方美颜的接入。
Android&iOS:TUICallKit 新增重载接口 call()、groupCall(),支持自定义离线消息(详情请参见 API文档)。

功能优化:

Android&iOS:优化部分 TUICallObserver 回调异常问题。
Android&iOS:优化视频切语音功能,支持离线状态下切换。
Android&iOS:完善 TUICallKit 的错误码及错误提示。
iOS:规范 TUICallEngine、TUICallKit Swift API 名称。

缺陷修复:

Android&iOS:修复重新登录账号后,仍会收到之前已拒绝的来电问题。
Android:修复单聊中收到群聊邀请,通话异常挂断问题。
Android:多场景退出直播间无法发起通话异常问题。
Android:修复 A 呼叫 B,同时 B 呼叫 C,C 概率性进入 A 的房间问题。

Version 1.1.0.103   @ 2022.09.30

Android&iOS:优化群组通话过程中,邀请群成员加入功能。
Android&iOS:优化通话流程,避免通话接听前产生录制、审核等费用。
Android&iOS:支持自定义音视频通话的离线推送消息。
Android&iOS:部分 TUICallEngine 接口参数变更,详见 call()、groupCall()、inviteUser()、以及回调接口onCallReceived()
Android&iOS:修复群组通话过程中,偶现的少量回调异常问题。
Android&iOS:修复重复登录以及UserSig过期造成的状态异常问题。
iOS:修复 TUCallKit Objective-C 和 Swift 混合编译时,init接口报错的问题。
Android:修复 Kotlin 集成悬浮窗功能时编译报错问题。

Version 1.0.0.53 @ 2022.08.15

全新发布:

Android&iOS:支持1v1 音视频通话、群组音视频通话。
Android&iOS:支持主流厂商的离线唤醒。
Android&iOS:支持自定义头像、自定义昵称。
Android&iOS:支持通话过程中开启悬浮窗。
Android&iOS:支持设置自定义铃音。
Android&iOS:支持多平台登录状态下的来电服务。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈