使用LMS接口创建一堂直播课全流程
流程图

同步账号
- 将机构的老师、学生同步到ClassIn
注册用户接口
注意填写 addSchoolmember 参数。
记录返回的uid,以供后面调用。
创建课程(班级)及课堂活动
一个直播课就是一个课堂活动,也即以前的课节 。
在创建课堂活动之前需要创建上层的班级和单元结构。
创建课程(其实是创建班级) 这里可以传班级名字、图片等
- 创建课堂活动
创建活动需要传入名字,老师和助教信息,课堂活动的时间(时长小于24小时)。
添加课堂成员
有两种方式添加学生参与活动,看业务逻辑
至此,学生和老师客户端就可以看到一个直播课入口了。到了开课时间,会有提醒及弹窗和按钮。
同时,我们提供了修改类接口。可在同目录下查看。
错误处理
对接中需要妥善处理错误码。
接口返回的错误码,大部分是与代码与业务逻辑相关,此时需要根据错误码调整实现逻辑或者调整参数。
另外,偶尔的网络连接不稳定导致接口超时或者报错在实践中也是不可避免的。所以我们建议机构在对接的时候,如果遇到这类错误,有以下两个建议:
- 对返回类似错误的接口进行适当的重试(1-3次)。
- 可以重试的接口包括:注册接口、添加老师接口、添加学生接口、课程下增删学生接口,课节下增删学生接口、修改课节、删除课节等。
- 如果添加了唯一标识这个参数,那么以下接口也支持重试,而不会产生重复数据:创建课程,创建课堂。
- 如果接口确实返回错误,也需要将错误反馈到终端用户,避免造成信息不一致。