tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务(TUILiveKit)
Demo 体验
Demo 体验指引
跑通 Demo(TUILiveKit)
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手(Electron 桌面应用)
推流助手(Web 桌面浏览器)
直播监播
监播页面(Web 桌面浏览器 React 版)
监播页面(Web 桌面浏览器 Vue 版)
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播(TUILiveKit)
至臻画质(TUILiveKit)
输入媒体流进房(TUILiveKit)
礼物系统(TUILiveKit)
客户端 API
Android
iOS
Web
服务端 API(TUILiveKit)
账号系统
REST API
第三方回调
错误码(TUILiveKit)
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice
文档直播 SDK直播监播监播页面(Web 桌面浏览器 React 版)

监播页面(Web 桌面浏览器 React 版)

聚焦模式
字号
最后更新时间: 2026-01-14 20:56:40

概述

本文对 TUILiveKit Demo 中的监播页面进行了详细的介绍,您可以在已有项目中直接参考本文档集成我们开发好的观看页面,也可以根据您的需求按照文档中的内容对页面的样式,布局以及功能项进行深度的定制。

功能概览

功能分类
具体能力
多路直播间同屏监播
支持同时展示8+路直播画面(具体数量可定制)。
低延迟播放
实时拉取直播流,画面延迟≤3秒。
独立音频控制
可单独开启/关闭任意一路直播间的声音,避免干扰。
一键查看详情
单击任意直播间窗口,快速进入详情页,查看主播信息等关键信息。
一键解散违规直播间
在详情页或监播面板直接操作,快速关停违规直播间,提升处置效率。

功能展示

监播页面提供默认行为和风格,但如果默认行为和样式不能完全满足您的需求,您也可以对 UI 进行自定义。其中主要包含直播多路直播间同屏监播、低延迟播放、独立音频控制、一键查看详情、一键解散违规直播间等。


快速跑通

步骤1:环境配置及开通服务

在进行快速接入之前,您需要参考准备工作,满足相关环境配置及开通对应服务。

步骤2: 下载 Demo

git clone https://github.com/Tencent-RTC/TUIKit_React.git

步骤3: 安装依赖

cd TUIKit_React/demos/live-monitor-react && npm install && cd server && npm install

步骤4: 启动服务端工程

// cd TUIKit_React/demos/live-monitor-react/server/config/index.js

const Config = {
SdkAppId: 0, // 输入您 TUILiveKit 服务的 SDKAppID
SecretKey: '', // 输入您 TUILiveKit 服务的 SDKSecretKey
Identifier: 'administrator',
Protocol: 'https://',
Domain: 'console.tim.qq.com',
Port: 9000,
};

module.exports = { Config };
// 执行如下命令启动服务,默认访问地址为:http://localhost:9000/api
npm run start

步骤5: 启动前端工程

// cd TUIKit_React/demos/live-monitor-react/src/config/index.ts

import { getBasicInfo } from './basic-info-config';

const sdkAppId = 0; // 输入您 TUILiveKit 服务的 SDKAppID
const secretKey = ''; // 输入您 TUILiveKit 服务的 SDKSecretKey
const defaultCoverUrl = ''; // 配置您直播封面的默认图片地址

const createBasicAccount = (userId?: string) => {
return getBasicInfo(userId || `live_${Math.ceil(Math.random() * 10000000)}`, sdkAppId, secretKey);
};

export { sdkAppId, secretKey, createBasicAccount, defaultCoverUrl };
// cd TUIKit_React/demos/live-monitor-react/src/views/LiveMointor/index.tsx

import React, { useLayoutEffect } from 'react';
import { useNavigate } from 'react-router-dom';
import { useLiveMonitorState } from 'tuikit-atomicx-react';
import { safelyParse } from '../../utils';
import { Header } from '../../components/Header';
import { LiveList } from '../../components/LiveList';
import { Pagination } from '../../components/Pagination';
import { PaginationProvider } from '../../context/PaginationContext';
import styles from './LiveMonitor.module.scss';

const LiveMonitor: React.FC = () => {
const { init, monitorLiveInfoList } = useLiveMonitorState();
const navigate = useNavigate();

useLayoutEffect(() => {
const account = safelyParse(localStorage.getItem('tuiLiveMonitor-userInfo') || '');

if (account) {
init({
baseUrl: 'http://localhost:9000/api', // 步骤4 中服务端默认访问地址
account: {
sdkAppId: 0, // 您 TUILiveKit 服务的 SDKAppID
userId: '', // 该用户在 步骤1 中的 userId
password: '', // 该用户在 步骤1 中的 userSig
},
});
} else {
navigate('/login');
}
}, [init, navigate]);

return (
<UIKitProvider theme="dark">
<div className={styles['live-monitor']}>
<Header />
<PaginationProvider>
<LiveList monitorLiveInfoList={monitorLiveInfoList} />
<div className={styles['live-pagination']}>
<Pagination pageSize={10} />
</div>
</PaginationProvider>
</div>
</UIKitProvider>
);
};

export default LiveMonitor;

npm run start

自由定制

通过上述方式您已经成功运行起监播页面的 Demo,此时若您需要对 UI 进行定制,您可以参考如下方式进行实现。其中定制内容包括但不限于对源码中的颜色主题、字体、圆角、按钮、图标、输入框、弹框等内容,都可以进行增加、删除、修改等操作,下列分别给出颜色主题、按钮以及图标的定制示例,您可以参考实现方式通用到其他组件,满足您的 UI 定制需要。


颜色主题

如步骤5中代码示例所示,您可以使用操作 theme 的值来满足您切换颜色主题。
<UIKitProvider theme="dark"> // theme 传入 dark 时,界面整体颜色主题为黑色主题
xxx // theme 传入 light 时,界面整体颜色主题为白色主题
</UIKitProvider>

按钮 Button

若您需要对按钮 Button 进行新增或替换等 UI 定制,您可以通过如下方式进行实现,以直播列表页面操作的三个按钮为例。参考下图,您可以找到对应 Button 指定位置源码,对当前部分的按钮进行增加、删除、替换等 UI 定制操作。


图标 Icon

若您需要对图标 Icon 进行新增或替换等 UI 定制,您可以通过如下方式进行实现,以直播列表中的 Icon 为例。通过下述指引,您可以找到对应 Icon 位置,进行增加、删除、替换等 UI 定制操作。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈