分组直播

最近更新时间:2026-01-27 15:18:52

我的收藏
说明:
本功能需要开通白名单才可使用。您可通过添加文档底部的 微信群 进行申请。

功能介绍

分组直播功能允许您将一个主课堂拆分为多个并行进行的子课堂。所有子课堂共享主讲老师的音视频画面和教学内容,但各子课堂内的学生之间相互隔离,无法互通。
老师视角可以看到所有子课堂:

注意:
分组直播使用限制:
1. 需开通旗舰版方可使用。
2. 最多支持创建10个分组。
3. 仅支持1名学生与老师进行全局连麦。
在分组直播模式下,不同角色的权限范围如下。为了方便理解,我们定义了两种可见范围:
全局可见:该内容对所有分组的师生可见。
组内可见:该内容仅对所在分组的师生可见。
角色\\功能
视频画面
白板/共享屏幕
互动消息
教学工具
花名册
老师
全局可见
全局可见
全局可见
全局可见
老师管理所有分组
助教
不适用
不适用
组内可见
不适用
仅管理所在分组
连麦学生
全局可见
全局可见
组内可见
不适用
不适用
未连麦学生
不适用
不适用
组内可见
不适用
不适用

开发流程

第一步:创建课堂

使用接口 CreateRoom 创建课堂时,重点关注以下参数配置,其余参数参考接口文档即可。
参数
说明
RoomType
填4代表分组直播。
MaxMicNumber
最大连麦人数,使用分组直播时只能填0或1。

第二步:创建分组

使用接口 CreateGroupLiveCodes 创建分组,生成分组直播参加码

第三步:进入指定分组

学生和助教进入课堂时,需要指定其分组。(老师无需额外操作)

1. 获取分组码

使用服务端接口 DescribeGroupLiveCodes 获取分组码。

2. 进入分组课堂

Web 端
electron 客户端
学生或助教进房时需要在课堂 URL 上拼接分组码,在原 URL 上拼接 groupLiveCode={分组码},示例:
注意:
分组码包含#号,因此拼接 URL 时,必须进行编码:encodeURIComponent(groupLiveCode) 。
老师的 URL 不需要拼接 groupLiveCode 参数。
https://class.qcloudclass.com/latest/class.html?userid=${userid}&token=${token}&classid=${classid}&schoolid=${schoolid}&groupLiveCode={groupLiveCode}
customParams里传参groupLiveCode,示例代码:
const TCIC = require('tcic-electron-sdk')
TCIC.initialize({
classId: '368507569',
userId: '123456',
token: 'token',
// 如果提供了url, 则url参数优先级高于上述参数
url: 'https://class.qcloudclass.com/latest/class.html?classid=xxxx&userid=xxx',
customParams?: {
groupLiveCode: '@TGS#_368507569@TOPIC#_d5ou4vg9g8h8vaskt13g' // 分组直播学生端需要传入
},
//其余参数请参考electron文档
})
说明:
移动端暂不支持,正在开发中。

联系我们

您有任何问题,可以扫码添加微信群与我们联系。