实时互动-教育版 分组直播

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

相关产品
实时互动-教育版 产品页,含版本规格、价格与购买入口。

注意:说明:

注意:本功能需要开通白名单才可使用,仅支持旗舰版。你可通过 联系我们 里的微信群进行申请。

一、功能介绍

老师视角可以看到所有子课堂:

注意:分组直播使用限制:

注意:1. 需开通旗舰版方可使用。

注意:2. 最多支持创建10个分组。

注意:3. 仅支持1名学生与老师进行全局连麦。

在分组直播模式下,不同角色的权限范围如下。为了方便理解,我们定义了两种可见范围:

·全局可见:该内容对所有分组的师生可见。

·组内可见:该内容仅对所在分组的师生可见。

角色\\功能 视频画面 白板/共享屏幕 互动消息 教学工具 花名册
老师 全局可见 全局可见 全局可见 全局可见 老师管理所有分组
助教 不适用 不适用 组内可见 不适用 仅管理所在分组
连麦学生 全局可见 全局可见 组内可见 不适用 不适用
未连麦学生 不适用 不适用 组内可见 不适用 不适用

二、第一步:创建课堂

使用接口 CreateRoom 创建课堂时,重点关注以下参数配置,其余参数参考接口文档即可。

参数 说明
RoomType 填4代表分组直播。
MaxMicNumber 最大连麦人数,使用分组直播时只能填0或1。

三、第二步:创建分组

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

四、第三步:进入指定分组

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

五、1. 获取分组码

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

六、2. 进入分组课堂

Web 端electron 客户端Android(Web 内核)iOS(Web 内核)原生内核

学生或助教进房时需要在课堂 URL 上拼接分组码,在原 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文档})

Android 需要 1.8.26 及以上版本才支持,示例代码:Intent intent = new Intent(getActivity(), TCICClassActivity.class);intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_SINGLE_TOP);Bundle bundle = new Bundle();TCICClassConfig initConfig = new TCICClassConfig.Builder() .schoolId(schoolId) .classId(classId) .userId(userId) .token(token) .groupLiveCode(groupLiveCode) //分组直播 .build();bundle.putParcelable(TCICConstants.KEY_INIT_CONFIG, initConfig);intent.putExtras(bundle);startActivity(intent);

iOS 需要1.8.5.18及以上版本才支持,示例代码:TCICClassConfig *roomConfig = [[TCICClassConfig alloc] init];roomConfig.schoolId = 123456;roomConfig.userId = "test";roomConfig.token = "test_token";roomConfig.classId = 654321;roomConfig.groupLiveCode = "@TGS#_368829238@TOPIC#_d5nf8ud2et7qpiel1260"; //分组直播[roomConfig setValue:@"en" forKey:@"language"]; //语言设置,可选[roomConfig setValue:@"scene_name" forKey:@"scene"]; //可根据场景配置不同的定制,可选[roomConfig setValue:@(0) forKey:@"preferPortrait"]; //默认横屏,可选(0 是横屏,1是竖屏)TCICClassController *vc = [TCICClassController classRoomWithConfig:roomConfig];if (vc) { [(UINavigationController *)self.window.rootViewController pushViewController:vc animated:YES];}else { NSLog(@"参数有误");}

正在开发中,敬请期待。

赞 (0)
上一篇 4天前
下一篇 4天前