发布日志(TUILiveKit)

最近更新时间:2025-09-01 15:01:41

我的收藏

2025年08月

发布动态
描述
发布时间
Version 3.3.0

新功能上线

视频混流多模板功能: 全平台新增多模板支持,现在观众可以获取麦位、麦上主播的媒体状态以及挂起状态。
画中画实验性 API: 新增画中画 API,欢迎开发者试用。
Flutter 平台功能补齐:
直播间列表插件接口已全部补齐。
新增完整的礼物功能。
Web 平台功能补齐:
补齐视频流预览 API。
补齐直播 PK 相关 API。

优化与改进

视频编码优化: 优化了不同视频混流模板下的视频上行编码,提升视频质量和性能。
接口注释优化: 优化了部分接口的注释,让文档更清晰易懂。

问题修复

修复了混流能力位不支持时导致的黑屏问题。
修复了单流上行无视频时渲染视图显示为黑色的问题。
修复了同账号多终端进房互踢后,进房状态异常的问题。
修复了新房间参与跨房连线后,未能及时上报媒体状态的问题。
修复了垫片推流状态下,视频状态异常的问题。
Android 平台: 修复了 TUILiveInfo 字段变更后,modify_flag 回调异常的问题。
iOS 平台: 修复了 TUILiveInfo 字段未能正确显示的问题。
Web 平台:
修复了视频播放器播放失败的问题。
修复了 setLiveInfo 接口因不兼容 basicRoomInfo 字段而导致调用失败的问题。
Flutter 平台: 修复了因线程问题无法准确监听通话和前后台状态的问题。


2025年07月

发布动态
描述
发布时间
Version 3.2.0

TUILiveKit 变更日志

​页面组件模块化更新

针对 iOS 与 Android 双平台,完成独立拆分直播全链路核心页面:

拆分出开播准备页直播页直播列表页观看页数据统计页五大核心页面组件。
支持开发者根据业务需求灵活按需接入,降低集成成本,提升定制化开发效率。

​礼物功能深度升级(RTCRoomEngine 联动)​​

全新升级礼物功能体系,覆盖数据统计、通知稳定性及国际化能力:
数据统计精准度提升:礼物相关数据同步更实时,统计维度更完整。
通知机制优化:礼物消息推送稳定性增强,减少漏发/延迟问题。
国际化支持:适配多语言场景,礼物名称/提示语支持本地化配置。
扩展能力开放:提供 TUILiveGiftManager 接口,支持通过丰富 RestAPI 及三方回调实现业务定制(详见接口文档)。


​RTCRoomEngine 变更日志

​直播管理接口扩展​

新增 TUILiveListManager 管理类核心接口:startLive(创建直播)、stopLive(结束直播)、joinLive(加入直播)、leaveLive(退出直播),覆盖直播间全生命周期管理。
​数据闭环增强​:调用 stopLive 接口时,新增返回观看人次礼物总量点赞数等关键统计数据,支持快速生成直播战报。
​分辨率动态感知​:新增 OnUserVideoSizeChanged 回调事件,实时通知观众端主播分辨率变化,优化画面显示体验。

​稳定性与合规性强化​

新增 license 失效错误码(-1005):当触发该错误时,视频播放功能将受限,提示App 需立即检查 license 有效性。
Android 端解码器预启动优化:通过预加载解码资源,显著缩短音视频首帧播放耗时(秒开体验提升)。
setLocalVideoMuteImage 接口增强:支持置空垫片图片,适配无自定义占位图的业务场景。​

​核心链路性能调优​

混流逻辑优化:调整推流策略与资源调度算法,降低混流延迟,提升画面流畅度。
QoS 自适应编码升级:根据网络状态动态调整编码参数(码率/分辨率),平衡画质与流畅性。
getUserList 接口优化:减少后台请求频次,同时规避客户端限频风险,保障列表拉取稳定性。

​多场景体验兼容​

直播与 CallKit 通话混用支持:允许直播过程中接听 CallKit 来电,通话结束后自动恢复直播状态,避免中断。
多人直播画布填充模式优化:支持自定义裁剪/缩放策略,适配不同比例屏幕,减少黑边/变形问题。
直播列表限频策略优化:优化 getRoomInfo 接口拉取逻辑,动态调整请求频率,降低触发服务端限频概率。


Web 端能力扩展与修复​

​ 新增核心 API​

直播连线功能:支持 Web 端发起/接听直播连麦,完善多人互动场景。
消息发送能力补齐:开放 sendTextMessage(文本消息)、sendCustomMessage(自定义消息)接口,支持业务消息透传。
房间元数据管理:新增 roomMetadata 相关 API,支持设置房间自定义信息(例如背景图、公告等)。

​关键问题修复​

直播中断恢复异常:修复主播因网络/设备问题中断后,观众侧持续黑屏无法恢复的问题。
麦位静音显示异常:修正语聊房场景下,麦位静音状态图标与实际状态不一致的显示问题。
Web 端播放混流黑屏:解决 Web 浏览器播放 TRTC 混流时偶现的黑屏问题。
getUserList 序列号异常:修复 Web 端调用接口返回 sequence 字段错乱的问题。
2025.7.16

2025年06月

发布动态
描述
发布时间
Version 3.1.0
TUILiveKit
新功能
Android & iOS:新增组件瀑布流列表组件。
Android & iOS:新增组件主播准备页组件。
功能增强
直播创建房间支持设置房主上麦后常驻麦位。
直播/观众端界面增加渐变色蒙层。
流程优化
优化观众列表显示逻辑。
优化进房拉取房间信息数据流程。
问题修复
iOS:优化断网状态下,连线功能 UI 异常问题。
iOS:修复异常退出 UI 导致的房间状态异常问题。
iOS:修复弱网环境下麦位请求 UI 异常/黑屏问题。
iOS:修复 iPhone 7 语聊房 UI 显示不全问题。
Android:修复偶现的观众数量与列表不一致问题。
Android:修复 PK 图标显示异常问题。
RTCRoomEngine SDK
问题修复
调整客户端能力位的加载时机,确保 RoomEngine callback 成功之前能力位加载完成。
新增消息接口,支持使用 RoomEngine 收到 IM 消息,并支持忽略禁言。
修复 TRTC 进房后返回 result 为 0 导致进房失败的问题。
SSO 通道的通知增加用户资料映射,减轻 SDK 并发补齐资料对后台的压力。
增加云控配置变更回调,及时更新配置中心和限频参数。
设置客户端码率上限,对齐官网。
修复 RoomEngine 与 TIMPush 混用时,账号无法登录的问题。
LiveStreamCore
新增接口
垫片推流接口。
功能优化
createRoom 新增 keepOwnerOnSeat 字段,支持房主永不下麦。
OnUserNetworkQualityChanged 回调新增观众拉流时本地网络质量检测。
onKickedOutOfRoom 回调增加被踢原因。
优化禁言列表、管理员列表的同步策略,降低后台请求频次。
优化直播连线的状态同步逻辑,降低后台请求频次。
优化观众未进房时预览拉流逻辑。
问题修复
修复未进房时的错误码未能正确返回的问题。
修复上麦之后没有清空本地的 layout 通知记录,导致下麦后拉混流时 layout 不再回调的问题。
修复重复退房时参数无效的问题。
修复网络异常恢复后,未能及时同步麦位信息导致的黑屏问题。
修复被拉黑封禁后,再次音画秒开,依然漏声音和画面的问题。
修复网络异常恢复后,本地用户下麦未能及时关闭采集的问题。
修复网络异常情况下,onRequestTimeout 回调中 TUIUserInfo 不准确的问题。
2025.06.10

2025年04月

发布动态
描述
发布时间
Version 3.0.0
TUILiveKit
Flutter:新增语聊房场景。
Flutter:统一国际化文案。
Flutter:修复已知问题。
iOS&Android:高级特效播放器鉴权问题修复。
iOS:端高级美颜支持使用历史效果。
iOS&Android:新增直播间用户管理功能(禁言、踢出房间、踢下麦、禁止音视频等)。
iOS&Android:删除未完整实现的功能(用户等级、音乐播放、直播类型)。
iOS&Android:修复频繁刷礼物导致直播间异常的问题。
iOS&Android:统一国际化文案。
iOS:端直播列表信息支持定制化修改。
Android:优化一些特殊机型导致的问题。
iOS&Android:连麦观众进房后自动下麦。
iOS&Android:修复已知问题。
LiveStreamCore
Flutter:新增语聊组件。
iOS:静态库发布。
iOS&Android:State状态可访问,可订阅变更。
iOS&Android:增加接口 switchCamera&enableMirror。
iOS&Android:统一国际化文案。
iOS&Android:修复已知问题。
RoomEngine SDK
新增功能
直播类型房间新增支持模糊搜索成员。
LayoutManager 新增自定义布局接口。
新增屏幕共享暂停接口。
Web 端补齐直播列表接口。
Web 端增加房间 metadata 接口。
接口变更
错误码变更。
OnRemoteUserEnterRoom/OnRemoteUserLeaveRoom 参数 userInfo 补齐禁言字段。
iOS 端禁言 API 的 Swift API 声明变更。
修复问题
优化屏幕分享异常问题。
修复 Android 偶现崩溃问题。
修复进房后可能无法打开麦克风问题。
2025.04.03

2025年02月

发布动态
描述
发布时间
Version 2.9.0
TUILiveKit
新功能:
Android&iOS:VideoLiveKit 接口增加:禁用关注功能,结束、退出直播间。
Android&iOS:悬浮窗支持主播端。
Web:支持自动拉快直播、UI 适配手机端浏览器、支持收发文字和表情消息。
Electron:优化混流排版能力。
Bug 修复:
Android&iOS:修复一些已知问题。
Electron:修复一些已知问题。
RoomEngine SDK
Flutter:新增连线、PK 功能支持。
全平台:onRoomUserCountChanged房间人数变更回调优化。
2025.02.12

2024年12月

发布动态
描述
发布时间
Version 2.8.0
稳定性优化:
iOS: 优化了弹幕组件的稳定性。
Bug 修复:
Android&iOS:修复一些已知问题。
2024.12.18

2024年11月

发布动态
描述
发布时间
Version 2.4.3
新功能
新增 LiveCoreView 组件。
支持悬浮窗功能。
2024.11.20

2024年10月

发布动态
描述
发布时间
Version 2.4.2
新功能
新增 VideoLiveKit、VoiceRoomKit 接口。
2024.10.12

2024年08月

发布动态
描述
发布时间
Version 2.4.1
新功能
新增直播连线功能。
2024.08.29

2024年07月

发布动态
描述
发布时间
Version 2.1.0
新功能
Android&iOS:演示交互升级。
Bug 修复
Android&iOS:修复了一些运行时崩溃的问题。
2024.07.22

2024年06月

发布动态
描述
发布时间
Version 2.0.0
新功能
Android&iOS:UI2.0交互更新。
Android&iOS:支持房间列表。
Android:支持滑动切换直播间。
2024.06.26

2024年05月

发布动态
描述
发布时间
Version 1.0.1
新功能
Android&iOS:支持语音聊天室场景。
Android&iOS:支持主播发弹幕。
Bug 修复
Android:修复麦克风连接问题和仪表盘显示问题。
Android:修复锁定座位时麦克风​​状态问题。
2024.05.24

2024年04月

发布动态
描述
发布时间
Version 1.0.0
新功能
Android&iOS:支持主播开播。
Android&iOS:支持观众进入直播间。
Android&iOS:支持观众话筒连接。
Android&iOS:支持观众列表。
Android&iOS:支持弹幕组件。
Android&iOS:支持礼物组件。
2024.04.22