tencent cloud

Tencent Real-Time Communication

Release Notes and Announcements
Release Notes
Recent Product Announcement
TRTC Live (TUILiveKit) Product Launch Announcement
TRTC Conference Official Editions Launched
The commercial version of Conference is coming soon
Terms and Conditions Applicable to $9.9 Starter Package
Rules for the "First Subscription $100 Discount" Promotion
Announcement on the Start of Beta Testing for Multi-person Audio and Video Conference
TRTC Call Official Editions Launched
License Required for Video Playback in New Version of LiteAV SDK
TRTC to Offer Monthly Packages
Product Introduction
Overview
Concepts
Features
Strengths
Use Cases
Performance Statistics
Tencent RTC Quickplay: Experience Ultimate Real-Time Audio and Video Interaction!
Purchase Guide
Billing Overview
Free Minutes
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
FAQs
Refund Instructions
User Tutorial
Free Demo
Call
Overview
Activate the Service
Run Demo
Integration
Offline Call Push
Conversational Chat
On-Cloud Recording
AI Noise Reduction
UI Customization
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
Release Notes
FAQs
Conference
Overview(TUIRoomKit)
Activate the Service (TUIRoomKit)
Run Demo(TUIRoomKit)
Integration(TUIRoomKit)
Screen Sharing (TUIRoomKit)
Schedule a meeting (TUIRoomKit)
In-meeting Call (TUIRoomKit)
UI Customization(TUIRoomKit)
Virtual Background (TUIRoomKit)
Conference Control (TUIRoomKit)
Cloud Recording (TUIRoomKit)
AI Noise Reduction (TUIRoomKit)
In-Conference Chat (TUIRoomKit)
Robot Streaming (TUIRoomKit)
Enhanced Features (TUIRoomKit)
Client APIs (TUIRoomKit)
Server APIs (TUIRoomKit)
FAQs (TUIRoomKit)
Error Code (TUIRoomKit)
SDK Update Log (TUIRoomKit)
Live
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Run Demo
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK Download
API Examples
Usage Guidelines
API Reference Manual
Advanced Features
AI Integration
Overview
Configure MCP Server
Install Skills
Integration Guide
FAQ
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
Console Guide
Application Management
Package Management
Usage Statistics
Monitoring Dashboard
Development Assistance
Solution
Real-Time Chorus
FAQs
Migration Guide
Billing
Features
UserSig
Firewall Restrictions
How to Downsize Installation Package
Android and iOS
Web
Flutter
Electron
TRTCCalling for Web
Audio and Video Quality
Others
Legacy Documentation
RTC RoomEngine SDK(Old)
Integrating TUIRoom (Web)
Integrating TUIRoom (Android)
Integrating TUIRoom (iOS)
Integrating TUIRoom (Flutter)
Integrating TUIRoom (Electron)
TUIRoom APIs
On-Cloud Recording and Playback (Old)
RTC Analytics Monthly Packages (Previous Version)
Protocols and Policies
Compliance
Security White Paper
Notes on Information Security
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC Policy
Privacy Policy
Data Processing And Security Agreement
Glossary

Host Live Streaming(Android)

PDF
Focus Mode
Font Size
Last updated: 2025-12-25 10:20:20
TUILiveKit Voice Chat Room is a ready-to-use interface providing all the core functionalities for starting a live stream. It enables you to integrate a host broadcasting flow into your app with simple steps.

Feature Overview

Pre-Live Preview: Allows hosts to configure personalized settings such as room name and cover image before going live.
Seat Management: Supports seat management operations including taking a seat, leaving a seat, muting, and locking seats.
Audience Interaction: Enables interactive features such as live chat (bullet comments), virtual gifts, and likes.
Live Room Management: Displays the online user list and provides moderation controls such as muting or removing users from the live room.
Pre-Live Preview
Seat Management
Audience Interaction
Live Room Management













Quick Integration

Enable the Service

Refer to Enable the Service to get the TUILiveKit trial version or paid version.

Component Integration

See Preparation for instructions on integrating TUILiveKit.

Create and Display the Voice Chat Room Activity

The VoiceRoomActivity component includes a complete built-in UI and business logic for the host side of the voice chat room. To enable host live streaming, simply launch this Activity. We recommend triggering the following logic in your app's Start Live button click event:
import android.content.Intent
import androidx.appcompat.app.AppCompatActivity
import com.tencent.cloud.tuikit.engine.room.TUIRoomDefine.SeatMode
import com.trtc.uikit.livekit.voiceroom.view.TUIVoiceRoomFragment.RoomBehavior.PREPARE_CREATE
import com.trtc.uikit.livekit.voiceroom.view.TUIVoiceRoomFragment.RoomParams
import com.trtc.uikit.livekit.voiceroom.view.VoiceRoomActivity

// YourActivity represents the page from which you start the live stream
class YourActivity : AppCompatActivity() {

// Handle the "Start Live" button click event
fun onStartVoiceRoomClicked() {

// 1. Configure room parameters (RoomParams)
// RoomParams must implement the Parcelable interface
val params = RoomParams().apply {
maxSeatCount = 10 // Maximum number of seats
seatMode = SeatMode.APPLY_TO_TAKE // Seat mode
}

// 2. Prepare the Intent and pass in the necessary parameters
val roomId = "test_voice_room_id"
val intent = Intent(this, VoiceRoomActivity::class.java).apply {
putExtra(VoiceRoomActivity.INTENT_KEY_ROOM_ID, roomId)
// behavior: PREPARE_CREATE means entering the pre-live preview page first
putExtra(VoiceRoomActivity.INTENT_KEY_CREATE_ROOM_PARAMS, params)
putExtra(VoiceRoomActivity.INTENT_KEY_ROOM_BEHAVIOR, PREPARE_CREATE.ordinal)
}

// 3. Navigate to the voice chat room page
startActivity(intent)
}
}
Intent Extra Parameter Description:
Parameter
Type
Description
VoiceRoomActivity.INTENT_KEY_ROOM_ID
string
Globally unique live room ID.
VoiceRoomActivity.INTENT_KEY_ROOM_BEHAVIOR
Int
Room entry behavior:
AUTO_CREATE: Automatically create the live room and enter.
PREPARE_CREATE: Enter the pre-live preview page first; after the user clicks "Start Live", create the live room and enter.
JOIN: Audience joins the room.
roomParams
RoomParams
Host live stream parameters. See the next section for details.
RoomParams Parameter Description:
Parameter
Type
Description
maxSeatCount
Int
Maximum number of seats in the live room.
seatMode
TUIRoomDefine.SeatMode
Audience seat mode:
APPLY_TO_TAKE: Audience must apply and be approved by the host before taking a seat.
FREE_TO_TAKE: Audience can take a seat without host approval.

Customize UI

TUILiveKit provides flexible interface customization to meet a variety of business needs. You can choose different layout templates and easily replace UI text and icons.

Live Layout Template Selection

TUILiveKit Voice Chat offers two layout styles. Select your preferred style using the layout button on the pre-live preview page:


Layout Overview:


Chat Room
KTV
Description
Default layout; displays only the seat grid.
Displays a KTV song player above the seat grid.
Preview







Text Customization (String Resources)

TUILiveKit uses standard Res-Common>Values>Strings.xml files to manage the text displayed in the UI. You can directly modify the strings that need adjustment via the XML file:


Icon Customization (Drawable Resources)

TUILiveKit uses the standard Android drawable resource folder to manage the image resources for the UI. You can quickly change the custom icons by replacing the resource files. When replacing, ensure that the new file names are consistent with the original file names.


Next Steps

You have now successfully integrated host live streaming. Next, implement features such as audience listening, live stream list and gift system. See the table below for details:
Feature
Description
Integration Guide
Audience Listening
Enables users to join as audience members, listen to the host, take seats, and view live chat (bullet comments).
Live Stream List
Displays a list of live rooms and their details.
Gift System
Support custom gift asset configuration, billing system integration, and gift-sending in PK scenarios.

FAQs

No sound after going live?

Ensure the app has microphone permission. Go to your phone's App Info > Permissions > Microphone and verify that microphone access is enabled.


Unable to go live when clicking the start button, with a "Not Logged In" prompt?

See Complete Login to ensure login functionality is properly integrated.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback