Releases: Tencent-RTC/TUILiveKit
v3.2.0
Here's the Markdown formatted version with proper hierarchy and technical formatting:
TUILiveKit & RTCRoomEngine Release Notes (July 16, 2025)
I. TUILiveKit Module Optimizations
Modular Refactoring of Page Components
- Completed componentization of core live streaming pages for iOS/Android platforms:
Live Preparation Page
|Live Room Page
|Live List Page
|Audience Page
|Analytics Page
- Enables selective component integration based on business needs
- Reduces integration costs and improves customization efficiency
Gift System Upgrade (RTCRoomEngine Integration)
- Enhanced gift data statistics accuracy:
• Real-time sync
• Comprehensive metrics - Optimized notification stability (reduced message delays/drops)
- Added multilingual support for gift names/notifications
- Introduced
TUILiveGiftManager
interface for customization:
• REST APIs
• Third-party callbacks
II. RTCRoomEngine Core Capability Upgrades
Live Management API Expansion
-
New
TUILiveListManager
interfaces:
swift
startLive() // Create live
stopLive() // End live
joinLive() // Join live
leaveLive() // Exit live -
Enhanced data reporting in
stopLive()
returns:
• Viewership counts
• Gift totals
• Like counts -
Added
OnUserVideoSizeChanged
callback for dynamic resolution adaptation
Stability & Compliance Enhancements
- New license failure error code
-1005
:- Restricts video playback when triggered
- Requires immediate license validation
- Android decoder preloading optimization:
↘️ Reduces first-frame latency by 60% setLocalVideoMuteImage
supports empty placeholder images
III. Performance & UX Improvements
Core Performance Tuning
- Optimized stream mixing logic:
↘️ 30% latency reduction
↗️ Enhanced visual fluency - Upgraded QoS adaptive encoding:
• Auto-adjusts bitrate/resolution
• Balances quality/fluency - Reduced
getUserList()
API frequency:
• Avoids throttling risks
• Ensures stable list retrieval
Multi-Scenario Compatibility
- CallKit integration:
Live streams auto-resume after phone calls - Canvas rendering optimization:
• Customizable aspect ratio strategies
• Eliminates black bars/distortion - Smart request throttling for
getRoomInfo()
API
IV. Web Platform Upgrades & Fixes
New Core APIs
-
Live Link
: Web co-streaming invitations -
Messaging APIs:
ts
sendTextMessage() // Text messages
sendCustomMessage() // Custom messages -
roomMetadata
APIs for custom properties:
• Background images
• Announcements
Critical Fixes
- Resolved audience-side black screen during stream recovery
- Fixed mic mute status icon inconsistency in voice chat rooms
- Fixed TRTC mixed-stream black screen on Web players
- Corrected
sequence
field errors ingetUserList()
responses
Key formatting features:
- Proper heading hierarchy (# → ## → ###)
- Code blocks for API interfaces ( __INLINECODETWO0__ts )
- Inline code formatting for technical terms (getUserList())
- Visual icons for performance metrics (
↘️ 30% latency reduction) - Nested bullet points for multi-level details
- Clean separation between sections and subsections
- Platform-specific annotations (Android/iOS/Web)
- Comments in code blocks for API explanations
- Clear visual hierarchy with consistent indentation
The format maintains technical precision while enhancing readability through:
• Semantic line breaks
• Strategic bolding for key features
• Vertical spacing between distinct components
• Symbolic indicators for metrics improvements
• Platform-aware syntax highlighting
v3.1.0
RTCRoomEngine 3.1.0 Version Change Log
Common
- Adjust the loading timing of client capability bits to ensure that the capability bits are loaded before the RoomEngine callback is successful.
- Add a new message interface, supporting receiving IM messages using RoomEngine and ignoring muting.
- Fix the issue where entering the room fails due to the TRTC returning a result of 0 after room entry.
- Add user profile mapping to the SSO channel notifications to reduce the pressure on the backend caused by the SDK concurrently supplementing data.
- Add a cloud control configuration change callback to update the configuration center and rate limit parameters in a timely manner.
- Set the client bitrate upper limit to be consistent with the official website.
- Fix the issue where the account cannot log in when RoomEngine and TIMPush are used together.
Live
- New Hidden Interfaces
- Support for UI internationalization.
- Support for image filling modes.
- New Functionality
- Padding stream pushing interface.
keepOwnerOnSeat
field added tocreateRoom
to support permanent microphone stay for room owners.
- Callback Enhancements
OnUserNetworkQualityChanged
: Added local network quality detection for viewers when pulling streams.onKickedOutOfRoom
: Added reason for being kicked.
- Optimizations
- Synchronization strategy for mute list and administrator list optimized to reduce backend request frequency.
- Status synchronization logic for live connections optimized to reduce backend request frequency.
- Preview stream pulling logic optimized for viewers not yet in the room.
- Bug Fixes
- Incorrect error code return when not entering the room.
- Local layout notification records not cleared after going on microphone, causing missing layout callbacks when pulling mixed streams after leaving microphone.
- Invalid parameters on repeated room exit.
- Black screen issue due to delayed microphone position synchronization after network recovery.
- Missing audio/video after being blocked and re-enabling instant play.
- Delayed closure of local collection after leaving microphone on network recovery.
- Inaccurate TUIUserInfo in
onRequestTimeout
callback under network anomalies.
TUILiveKit 3.1.0 Version Change Log
iOS and Android
- New Components
- Waterfall flow list component.
- Anchor preparation page component.
- Feature Additions
- Live room creation supports setting room owner to stay on microphone after joining.
- Gradient color overlay added to live/viewer interface.
- Optimizations
- Viewer list display logic optimized.
- Room information fetching flow on entry optimized.
- Platform-Specific Fixes
- iOS
- UI anomalies in connection function under network disconnection fixed.
- Abnormal room status on UI exit fixed.
- Microphone request UI/black screen issues in weak networks fixed.
- Incomplete UI display on iPhone 7 voice chat room fixed.
- Android
- Occasional viewer count mismatch with list fixed.
- PK icon display anomaly fixed.
- iOS
v3.0.1
Fix iOS issues
v3.0.0
TUILiveKit Release Notes
Version 3.0
RoomEngine
New Features
- Added fuzzy member search support for live streaming rooms
- Added custom layout interface in LayoutManager
- Added screen sharing pause interface
- Completed live list interface for Web
- Added room metadata interface for Web
API Changes
- Error code updates
- Added mute field to userInfo parameter in OnRemoteUserEnterRoom/OnRemoteUserLeaveRoom
- Swift API declaration changes for mute APIs on iOS
Bug Fixes
- Optimized screen sharing exceptions
- Fixed occasional crashes on Android
- Fixed potential microphone activation failure after entering room
LiveStreamCore
Flutter
- New live streaming & voice chat components
iOS & Android
- Static library release
- State status now accessible and subscribable
- Added switchCamera & enableMirror interfaces
- Unified internationalization copywriting
- Fixed known issues
TUILiveKit
Flutter
- New voice chat room scenario
- Unified internationalization copywriting
- Fixed known issues
iOS & Android
- Fixed authentication issues with advanced effects player
- iOS advanced beauty effects now support historical presets
- Added live room user management (mute, kick, remove from stage, AV ban, etc.)
- Removed incomplete features (user level, music playback, live streaming types)
- Fixed abnormal room behavior caused by frequent gifting
- Unified internationalization copywriting
- iOS live list information now supports customization
- Optimized compatibility issues with specific Android models
- Audience automatically leaves stage when entering room via co-streaming
- Fixed known issues
v2.9.0
【TUILiveKit】【Android】Published version 2.9.0
v2.8.1
【LiveKit】【Android】【V2.8.0】fix aar problem
V2.8.0
Feature:
- Add LiveStreamCoreView & SeatGirdView.
- Support Flowting window
v2.4.3
【TUILiveKit】【iOS】Fix the issue where the host does not go live when e…
v2.4.2
Added VideoLiveKit and VoiceRoomKit interface.
v2.4.1
【TUILiveKit】【Android】supports battle