文档中心>直播 SDK>语聊房>观众观看>观众观看(Android)

观众观看(Android)

最近更新时间:2025-11-21 14:15:33

我的收藏
TUILiveKit语聊房为纯音频直播场景提供了开箱即用的全功能界面。它支持快速搭建观众观看、上麦互动所需的核心能力,让您无需关注复杂的 UI 与麦位管理逻辑。

功能概览

收听直播: 清晰、流畅地收听主播的实时音频直播。
上麦互动: 申请上麦,与主播进行音频连麦互动。
直播间信息: 查看直播间公告,及在线观众列表等信息。
观众互动: 支持弹幕、礼物、点赞 等丰富的直播互动形式。
收听直播
上麦互动
直播间信息
观众互动





快速接入

步骤1:开通服务

参考 开通服务 文档开通「体验版」或「大规模直播版」套餐。

步骤2:代码集成

参考 准备工作 接入 TUILiveKit

步骤3:创建并展示语聊房视图控制器

VoiceRoomActivity 组件已内置了语聊房场景的观众端完整 UI 与业务逻辑。您只需启动该 Activity ,即可快速实现观众进入直播间功能。通常在 直播列表 点击房间时,您需要跳转到观众观看页,可参考如下代码示例:
import android.content.Intent
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.trtc.uikit.livekit.voiceroom.VoiceRoomActivity
import com.trtc.uikit.livekit.voiceroom.VoiceRoomDefine

// YourLiveListActivity 代表您的直播列表页面
class YourLiveListActivity : AppCompatActivity() {

// 响应“点击直播间”
fun onJoinVoiceRoomClicked(roomId: String) {

// 1. 准备 Intent,并传入必要参数
// - roomId: 您要加入的直播间 ID
// - behavior: VoiceRoomDefine.RoomBehavior.JOIN 代表以“观众”身份加入房间
val intent = Intent(this, VoiceRoomActivity::class.java).apply {
putExtra(VoiceRoomActivity.INTENT_KEY_ROOM_ID, roomId)
putExtra(VoiceRoomActivity.INTENT_KEY_ROOM_BEHAVIOR, JOIN.ordinal)
}

// 2. 跳转到语聊房页面
startActivity(intent)
}
}
Intent Extra 参数说明:
参数名
类型
描述
VoiceRoomActivity.INTENT_KEY_ROOM_ID
string
全局唯一的直播间 Id
VoiceRoomActivity.INTENT_KEY_ROOM_BEHAVIOR
Int
进房行为:
AUTO_CREATE:自动创建直播间并进房。
PREPARE_CREATE: 先进入开播前预览页,用户点击“开始直播”后创建直播间并进房。
JOIN:观众进房。

自定义您的界面

TUILiveKit 提供了界面定制能力,以满足多样化的业务需求。 您可以轻松自定义界面中的文案和图标。

文案修改

TUILiveKit 使用 Android 标准的 字符串资源 (strings.xml) 来管理 UI 所需的文案显示。您可以直接修改 tuilivekit 模块中的 strings.xml 文件,以实现文案自定义。



图标替换

TUILiveKit 使用 drawable 资源来管理 UI 所需的图片资源。您可以直接在 tuilivekit 模块的 res/drawable 目录下替换同名图片资源,以实现图标替换。


下一步

恭喜您,现在您已经成功集成了观众观看。接下来,您可以实现主播开播直播列表等功能,可参考下表:
功能
描述
集成指引
主播开播
主播开播全流程功能,包括开播前的准备和开播后的各种互动
直播列表
展示直播列表界面和功能,包含直播列表,房间信息展示功能

常见问题

观众上麦后,说话没有声音?

请检查是否已授予 App 麦克风权限。您可以前往手机 应用信息 > 权限 > 麦克风,检查“麦克风”权限是否已开启。


观众发送弹幕时,直播间内其他观众看不到弹幕内容?

原因 1: 先检查网络连接,确保观众设备网络正常。
原因 2: 该观众被主播禁言,无法发送弹幕。
原因 3: 观众的弹幕内容涉及关键词屏蔽,请确认观众发送的弹幕内容是否符合直播间规则。