TUILiveKit 的直播列表能力基于 LiveList 组件,以竖向分页信息流的形式展示多个直播间,PC 与 H5 自适应布局。可快速集成到您的应用中。
集成提示:
功能概览
直播间列表:展示封面、房间名、主播信息与观看数;PC / H5 自适应卡片网格。
下拉刷新:H5 端支持下拉刷新,PC 端滚动到底部加载更多。
自动分页:滑动接近列表底部时自动续拉下一页,游标为空时显示没有更多。
Web | H5 |
![]() | ![]() |
组件说明
LiveList 从 @tencentcloud/livekit-web-vue3 包根具名导出,内部渲染 tuikit-atomicx-vue3 的列表组件并转发点击事件。组件列表数据由 LiveListState 状态驱动;组件本身不进房、不拉流。快速接入
步骤1:服务
步骤2:代码集成
注意:
创建 LiveList 组件之前,请确保已完成登录,否则拉取列表数据会失败。
步骤3:接入 LiveList 组件
<template><LiveListbrand-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 | |
logout | () => void | PC、H5 | 需自行调用 logout 接口退出登录,再卸载组件/路由跳转。 |
下一步
恭喜您,现在您已经成功集成了直播列表。接下来,您可以实现主播开播、观众观看等功能,可参考下表:

