本页介绍灵动课堂涉及的几个基本概念,以便于你更好地理解和使用灵动课堂。
灵动课堂中的“用户”可以理解为角色。每个角色在课堂中的最小单位是用户,每个用户都拥有以下属性:
以上属性可由开发者在客户端调用 launch
方法时设置。
灵动课堂中的“房间”可以理解为线下教学场景中的教室。一个教室可以在不同时间、由不同授课老师使用不同教材完成不同的课程。线下教学教室通常会存在普通教室、实验教室、多媒体教室等类型,灵动课堂的房间也有不同的分类。每个房间都拥有以下属性:
房间的创建可以由客户端调用 launch
方法创建,也可以由后端调用创建课堂 RESTful API 创建,声网更推荐后端统一调用 RESTful API 创建。
以上属性可由开发者在客户端调用 launch
方法时设置。灵动课堂会以该房间第一位进入的用户传入的参数(房间 ID、房间名称、房间类型)自动创建一个房间。后续进入的用户调用 launch
方法时,传入相同的参数(房间 ID、房间名称、房间类型),就会加入到同一个房间。房间内所有用户离开后一小时,声网会自动销毁该房间。
灵动课堂中的“课堂”可以理解为线下教学场景中的一节课程。每个课堂可以设定以下属性:
以上属性可由开发者在客户端调用 launch
方法时设置。灵动课堂会以该房间第一位进入的用户传入的参数设置课堂属性。
定义
灵动课堂中的“流”可以理解为音视频流以及用户发送音视频流的权限。音视频流是在灵动课堂中实现实时音视频互动的传输介质。开发者可通过 API 给予某个用户进行特定操作的权限。同一个用户可以有多路流,例如,一个用户可能既有发送本地音视频的权限,又有分享屏幕的权限。
当开发者调用 addCoHost
方法时,可为指定用户创建一条流,给予该用户发送音频或视频的权限,同时灵动课堂服务端会自动生成一个流 ID。当开发者调用 removeCoHost
方法时,可将某个用户的一条流永久销毁。