TUILiveKit 的观众观看页为用户提供了丰富且便捷的直播观看与互动功能,能快速集成到您的应用中,满足观众多样化的需求。
集成提示:
功能概览
直播观看:清晰、流畅观看主播实时直播画面,可查看直播间标题、主播信息及在线观众。
直播互动:送礼物(有动画特效,主播接收提示)、点赞(有动画及实时统计)、发弹幕互动,并可申请与主播音视频连麦互动。
Web 观众观看 | Web 观众和主播连麦 |
![]() | ![]() |
H5 观众观看 | H5 观众和主播连麦 |
![]() | ![]() |
组件说明
LivePlayer 用于观看单个直播间,适用于直接进入某一个直播间的场景(如分享链接、开播推送通知),组件内已包含拉流、进房、连麦、弹幕、礼物、点赞等完整交互 UI。快速接入
步骤 1:开通服务
步骤 2:代码集成
注意:
接入 LivePlayer 之前,请确保已完成登录,否则拉流与进房会失败。
步骤 3:使用 LivePlayer 观看单个直播间
在您的观众观看组件中引入并使用 LivePlayer 组件:
<template><UIKitProvider theme="dark"><LivePlayer v-if="isLogin" :live-id="liveId" @leave="onLeave" /></UIKitProvider></template><script setup lang="ts">import { computed, onMounted, ref } from 'vue';import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3';import { useLoginState, LoginStatus } from 'tuikit-atomicx-vue3';import { LivePlayer } from '@tencentcloud/livekit-web-vue3';const { login, loginStatus } = useLoginState();const liveId = ref(new URLSearchParams(location.search).get('liveId') || '');const isLogin = computed(() => loginStatus.value === LoginStatus.LOGINED);const onLeave = () => { liveId.value = ''; };onMounted(() => {try {login({sdkAppId: 0, // SDKAppID - 开通服务时获取的 SDKAppIDuserId: '', // UserID - 用户 IDuserSig: '', // userSig - 用户签名,详细获取方式请参照下文参数说明});} catch (error) {console.error('登录失败:', error);throw error;}});</script>
组件 API 说明
LivePlayer
观众播放页,从
@tencentcloud/livekit-web-vue3 导入。包在模块加载时按设备环境(isMobile)自动选用 LivePlayerPC / LivePlayerH5 实现。Props
属性 | 类型 | 必填 | 默认值 | 说明 |
liveId | string | 是 | - | 直播间 ID。 |
Events
事件 | 参数 | 说明 |
leave | 无 | 用户点击退出直播间按钮(组件内部会先调用 leaveLive() 方法)或被主播踢出直播间均会触发。组件内部已根据不同原因的直播间退出方式做了处理,leave 事件触发后只考虑路由跳转即可。 |
下一步
恭喜您,现在您已经成功集成了观众观看。接下来,您可以实现主播开播、直播列表等功能,可参考下表:



