TUILiveKit语聊房为纯音频直播场景提供了开箱即用的全功能界面。它支持快速搭建主播开播所需的核心能力,让您无需关注复杂的 UI 与麦位管理逻辑,即可高效集成语聊房开播流程。功能概览
开播前预览: 支持主播开播前设置房间名称、封面等个性化配置。
麦位管理: 支持上麦、下麦、禁麦、锁麦等多种麦位管理操作。
观众互动: 支持弹幕、礼物、点赞 等丰富的直播互动形式。
直播间管理: 支持在线用户列表展示,以及直播间内的禁言、踢人 等多种管理操作。
开播前预览 | 麦位管理 | 观众互动 | 直播间管理 |
![]() | ![]() | ![]() | ![]() |
快速接入
步骤 1:开通服务
步骤 2:代码集成
步骤 3:创建并展示语聊房视图控制器
VoiceRoomActivity 组件已内置了语聊房场景的主播端完整 UI 与业务逻辑。您只需启动该 Activity,即可快速实现主播开播功能。推荐在您 App 的“开始直播”按钮点击事件中,执行以下逻辑:import android.content.Intentimport androidx.appcompat.app.AppCompatActivityimport com.tencent.cloud.tuikit.engine.room.TUIRoomDefine.SeatModeimport com.trtc.uikit.livekit.voiceroom.view.TUIVoiceRoomFragment.RoomBehavior.PREPARE_CREATEimport com.trtc.uikit.livekit.voiceroom.view.TUIVoiceRoomFragment.RoomParamsimport com.trtc.uikit.livekit.voiceroom.view.VoiceRoomActivity// YourActivity 代表您发起直播的页面class YourActivity : AppCompatActivity() {// 响应“开始直播”按钮点击事件fun onStartVoiceRoomClicked() {// 1. 配置房间参数 (RoomParams)// RoomParams 需要实现 Parcelable 接口val params = RoomParams().apply {maxSeatCount = 10 // 最大麦位数量seatMode = SeatMode.APPLY_TO_TAKE // 上麦模式}// 2. 准备 Intent,并传入必要参数val roomId = "test_voice_room_id"val intent = Intent(this, VoiceRoomActivity::class.java).apply {putExtra(VoiceRoomActivity.INTENT_KEY_ROOM_ID, roomId)// behavior: PREPARE_CREATE 代表先进入开播前预览页putExtra(VoiceRoomActivity.INTENT_KEY_CREATE_ROOM_PARAMS, params)putExtra(VoiceRoomActivity.INTENT_KEY_ROOM_BEHAVIOR, PREPARE_CREATE.ordinal)}// 3. 跳转到语聊房页面startActivity(intent)}}
Intent Extra 参数说明:
参数名 | 类型 | 描述 | |
VoiceRoomActivity.INTENT_KEY_ROOM_ID | | string | 全局唯一的直播间 Id。 |
VoiceRoomActivity.INTENT_KEY_ROOM_BEHAVIOR | | Int | 进房行为: AUTO_CREATE:自动创建直播间并进房。PREPARE_CREATE: 先进入开播前预览页,用户点击“开始直播”后创建直播间并进房。JOIN:观众进房。 |
roomParams | | RoomParams | 主播开播参数,详见下一节。 |
RoomParams 参数说明:
参数名 | 类型 | 描述 |
maxSeatCount | Int | 直播间最大麦位数。 |
seatMode | TUIRoomDefine.SeatMode | 观众的上麦模式: APPLY_TO_TAKE:观众需要申请,主播同意后上麦FREE_TO_TAKE: 观众自由上麦,无需主播同意。 |
自定义您的界面布局
TUILiveKit 提供了界面定制能力,以满足多样化的业务需求。您不仅可以选择不同的布局模板,还可以轻松替换界面中的文案和图标。直播布局模板选择
TUILiveKit 语聊提供 2 种布局样式,您可在主播开播前预览页的 UI 交互布局按钮选择合适样式:
布局概览:
名称 | 聊天室 | KTV |
描述 | 默认布局,页面只显示麦位网格图。 | 麦位网格图上方显示KTV歌曲播放器。 |
预览 | ![]() | ![]() |
文案修改
TUILiveKit 使用 Android 标准的 字符串资源 (strings.xml) 来管理 UI 所需的文案显示。您可以直接修改 tuilivekit 模块中的 strings.xml 文件,以实现文案自定义。
图标替换
TUILiveKit 使用 drawable 资源来管理 UI 所需的图片资源。您可以直接在 tuilivekit 模块的 res/drawable 目录下替换同名图片资源,以实现图标替换。
下一步
恭喜您,现在您已经成功集成了 主播开播 。接下来,您可以实现观众观看、直播列表等功能,可参考下表:
常见问题
开播后没有声音?
请检查是否已授予
App 麦克风权限。您可以前往手机 应用信息 > 权限 > 麦克风,检查“麦克风”权限是否已开启。





