本文引导您跑通 TUIRoomKit 在线课堂 Web 端 Demo,分别以老师和学生身份体验 1v1 在线课堂中的预约上课、白板授权、屏幕分享、发奖杯、课堂消息等核心功能。
Demo 效果预览
下图为 1v1 在线课堂课中界面示意,展示了老师画面、学生画面、白板区域及各项课堂能力入口。

前提条件
开通服务
SDKAppID:应用标识,腾讯云基于
SDKAppID 完成计费统计。SDKSecretKey:应用密钥,用于初始化配置文件的密钥信息。
环境准备
Node.js:≥ 18.19.1 (推荐使用官方 LTS 版本)。
浏览器:推荐使用最新版 Chrome,或其他支持 WebRTC API 的现代浏览器。
媒体设备:建议配备摄像头、麦克风和扬声器。缺少相应设备时仍可进入课堂,但对应音视频能力不可用。
跑通步骤
步骤1:下载源码
访问 GitHub 仓库,克隆项目源码到本地。
git clone https://github.com/Tencent-RTC/TUIRoomKit.git --depth=1
步骤2:进入项目目录
cd TUIRoomKit/Web/example/edu-vite-vue3-ts
步骤3:安装依赖
在项目目录下,安装项目所需的依赖包。
npm install
pnpm install
yarn
步骤4:配置应用信息
在项目目录中找到
TUIRoomKit/Web/example/edu-vite-vue3-ts/src/config/basic-info-config.js 配置文件,并将您在腾讯云控制台获取的 SDKAppID 和 SDKSecretKey 填入对应的变量中。
警告:
本文的 Demo 示例中通过在客户端代码中配置
SDKSecretKey 进行鉴权,但 SDKSecretKey 很容易被反编译逆向破解,一旦密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。在正式的生产环境中,建议在您的服务端生成 UserSig,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig 来进行鉴权。详见 正式运行阶段如何计算 UserSig?
步骤5:启动项目
运行下列命令来启动开发服务器。
npm run dev
pnpm run dev
yarn run dev
启动成功后,在浏览器中访问终端输出的地址(通常为
http://localhost:5173)。步骤6:体验 1v1 在线课堂
老师与学生体验提示
1v1 课堂需要老师和学生 2 个客户端同时在线。建议使用两个浏览器窗口 + 两个不同用户 ID 进行体验。
1. 打开两个浏览器标签页,分别填写用户 ID(自定义字符串即可,如老师使用
teacherA、学生使用 studentB),勾选同意隐私条例和用户协议后,点击登录。老师 | 学生 |
![]() | ![]() |
2. 老师进入准备上课页,确认浏览器已授权摄像头、麦克风权限后,切换到预约课堂页签,填写课堂名称、开始时间和课堂时长,点击预约。预约成功后,在课程列表的课程卡片中复制课程号并发送给学生。学生在页面右上角将身份切换为学生,切换到加入课堂页签,输入老师发送的课程号。
老师 | 学生 |
![]() | ![]() |
3. 老师在课程列表中点击该课堂的进入课堂,创建课堂的老师为房主,拥有课堂内的管理权限;学生点击加入课堂,进入同一课堂。老师也可以在课程卡片中点击复制邀请,将课堂链接发送给学生,学生打开链接并登录后,课程号会自动填入加入课堂页签。
老师 | 学生 |
![]() | ![]() |
能力说明
老师和学生进入课堂后,可参考下表体验在线课堂核心能力,顺序不限;设备设置、虚拟背景等其他能力可按需体验。
功能 | 如何体验 | 说明 |
白板授权与屏幕共享 | 老师开启白板或屏幕分享,内容显示在课堂主画面;在学生画面上点击授权白板,学生即可在白板上书写,点击收回白板取消授权。 | 白板与屏幕共享互斥;建议共享标签页,避免无限镜像。 |
花名册与课堂消息 | 老师点击花名册:对学生发奖杯、请求打开麦克风或摄像头、禁言、移出等; 在课堂消息区域发送文字消息,另一端可实时收到。 | 仅老师可管理学生;老师发送的消息带有老师标识。 |
主画面互换 | 白板或屏幕分享进行中,老师点击与主画面互换,可将老师画面与白板互换位置。 | 仅老师可操作,学生端画面同步切换。 |
下课与离开 | 点击离开课堂:老师可选择下课(结束课堂,学生同步离开)或暂时离开(课堂继续);学生离开后仍可再次进入。 | 老师下课后,学生端会提示“老师已下课,课堂已结束”。 |
下一步
恭喜您!您已经成功跑通了 TUIRoomKit 在线课堂 Vue3 项目。您可以根据业务需求,参考以下集成指引将在线课堂集成到您的项目中:
页面 | 文档链接 |
快速接入(在线课堂) |
常见问题
配置 SDKAppID 和 SDKSecretKey 后仍无法登录或进入课堂?
核对配置项:确认
src/config/basic-info-config.js 中的 SDKAppID 和 SDKSecretKey 与 TRTC 控制台 应用信息一致,保存文件后需重启 npm run dev。核对开通状态:确认已完成 开通服务,体验版应用未过期。
核对进入方式:学生需在加入课堂页签输入课程号,或打开老师分享的课堂链接进入;老师和学生两个客户端须使用不同用户 ID。
学生的课程列表中看不到老师预约的课堂?
确认参与成员:老师预约时在参与成员中填写的须为该学生的用户 ID。
确认课堂状态:课程列表只展示未结束的课堂,已取消或已结束的课堂不会显示。可通过上一周、下一周切换日期查看。
刷新课程列表:若老师刚完成预约,请刷新学生页面后重试。
白板无法打开或提示“白板开启失败”?
检查网络:白板依赖在线资源文件,Demo 默认从公网 CDN 加载,请确认当前网络可以访问该资源地址。
重新打开:在课堂中点击重新打开白板重试。
页面提示无法使用麦克风或摄像头设备?
检查浏览器权限:确认地址栏已允许当前页访问摄像头、麦克风。Chrome 可点击地址栏左侧图标,将摄像头和麦克风设为允许后刷新页面。

检查设备占用:关闭其他正在使用摄像头的应用(如视频会议软件、浏览器其他标签页),然后刷新 Demo 页面重试。
检查浏览器兼容性:请使用支持 WebRTC APIs 的现代浏览器(推荐最新版 Chrome)。
屏幕共享时出现无限镜像?
原因:共享了整个屏幕或整个浏览器窗口时,课堂画面本身也被纳入共享区域,浏览器会呈现画面套进画面的无限镜像效果。
解决方案:发起屏幕共享时,选择单个标签页或独立应用窗口,不要选择整个屏幕或整个浏览器窗口。
必须共享整个屏幕时:如有外接显示器,可采用以下任一方式避免共享画面包含课堂窗口本身,从而避免无限镜像:
将课堂页面拖到外接屏上操作,在本机主屏共享整个屏幕;
发起屏幕共享时直接选择外接显示器桌面进行共享。





