帮你快速理解、总结文档立即下载

直播列表(Web&H5 React)

最近更新时间:2026-11-17 17:38:30
我的收藏
TUILiveKit 的直播列表能力基于 LiveList 组件,以竖向分页信息流的形式展示多个直播间,PC 与 H5 自适应布局。可快速集成到您的应用中。
集成提示:
本文档介绍基于 UI 组件 的直播列表接入方式(含完整交互 UI)。若您只需观看单个直播间,请参考 观众观看;若您需通过 Core SDK 自行搭建界面,请参考 观众观看 (Core SDK)。

功能概览

直播间列表:展示封面、房间名、主播信息与观看数;PC / H5 自适应卡片网格。
下拉刷新:H5 端支持下拉刷新,PC 端滚动到底部加载更多。
自动分页:滑动接近列表底部时自动续拉下一页,游标为空时显示没有更多。
Web
H5







组件说明

LiveList 从 @tencentcloud/livekit-web-react 包根具名导出,内部渲染 tuikit-atomicx-react 的列表组件并转发点击事件。组件列表数据由 LiveListState 状态驱动;组件本身不进房、不拉流。

快速接入

步骤1:服务

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

步骤2:代码集成

参考 准备工作 接入 TUILiveKit,并完成 AtomicXCore 登录。
注意:
创建 LiveList 组件之前,请确保已完成登录,否则拉取列表数据会失败。

步骤3:接入 LiveList 组件

import { useNavigate } from 'react-router-dom';
import { loginClient } from 'tuikit-atomicx-react';
import { LiveList } from '@tencentcloud/livekit-web-react';

export function LiveListPage() {
const navigate = useNavigate();

function handleRoomClick(liveInfo: { liveId: string }) {
// 接入 LivePlayer 组件后,跳转到播放页
navigate({ pathname: '/live-player', search: `?liveId=${liveInfo.liveId}` });
}
function handleStartLive() {
// 接入 LivePusher 组件后,跳转到开播页
navigate('/live-pusher');
}
async function handleLogout() {
// 调用业务侧登出逻辑,之后跳转登录页
await loginClient.logout();
navigate('/login');
}

return (
<LiveList
brandName="LiveKit"
logoUrl="/logo.svg"
onLiveRoomClick={handleRoomClick}
onStartLive={handleStartLive}
onLogout={handleLogout}
/>
);
}

组件 API 说明

Props
属性
类型
必填
生效端
说明
logoUrl
string
否
PC、H5
顶部品牌 logo 地址。
brandName
string
否
PC、H5
顶栏品牌名称。
回调
回调
参数
生效端
说明
onLiveRoomClick
LiveInfo
PC、H5
点击房间卡片后触发,将返回参数 liveInfo.liveId 携带跳转到播放页。
onStartLive
无
PC、H5
点击直播列表内的开播按钮后触发,路由跳转到 LivePusher 组件。
onLogout
() => void
PC、H5
需自行调用 logout 接口退出登录,再卸载组件/路由跳转。

下一步

恭喜您,现在您已经成功集成了直播列表。接下来,您可以实现主播开播、观众观看等功能,可参考下表:
功能
描述
集成指引
观众观看
使用 LivePlayer 观看单个直播间,包含拉流、进房与互动能力。
主播开播
主播开播全流程功能,包括开播前的准备和开播后的各种互动。