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

直播列表(Web&H5 Vue3)

最近更新时间: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-vue3 包根具名导出,内部渲染 tuikit-atomicx-vue3 的列表组件并转发点击事件。组件列表数据由 LiveListState 状态驱动;组件本身不进房、不拉流。

快速接入

步骤1:服务

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

步骤2:代码集成

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

步骤3:接入 LiveList 组件

<template>
<LiveList
brand-name="LiveKit"
logo-url="/logo.svg"
@live-room-click="handleRoomClick"
@start-live="handleStartLive"
@logout="handleLogout"
/>
</template>

<script setup lang="ts">
import { useRouter } from 'vue-router';
import { LiveList } from '@tencentcloud/livekit-web-vue3';

const router = useRouter();

function handleRoomClick(liveInfo: { liveId: string }) {
// 接入 LivePlayer 组件后,跳转到播放页
router.push({ path: '/live-player', query: { liveId: liveInfo.liveId } });
}
function handleStartLive() {
// 接入 LivePusher 组件后,跳转到开播页
router.push('/live-pusher');
}
function handleLogout() {
// 调用业务侧登出逻辑,之后跳转登录页
router.push('/login');
}
</script>

组件 API 说明

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

下一步

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