编辑在线双师课节
接口功能: 修改在线双师主子课节的主讲教师、助教、时间等信息
接口说明:
- 此接口仅支持修改在线双师主子课节
- 主课节修改主讲教师、时间时会同步修改子课节
- 子课节不允许修改主讲教师、时间
- 此接口支持仅传递需修改的参数,可传一个或多个;全都不传,报【参数不全】错误
- 子课节如果需要修改录课直播回放,需同时传递useCoMainRecord、recordState、recordType、liveState、openState,否则会报参数错误
URL
https://root_url/lms/onlineDoubleTeacher/editClass
HTTP Request Methods
- POST
编码格式
- UTF-8
请求参数
Header 参数
key | 必填 | 类型 | 说明 |
---|---|---|---|
X-EEO-SIGN | 是 | string | 签名 生成规则见这里 |
X-EEO-UID | 是 | string | 机构SID |
X-EEO-TS | 是 | string | 时间戳 |
Body 参数
key | 必填 | 类型 | 说明 | 规则说明 |
---|---|---|---|---|
courseId | 是 | integer | 课程ID | 创建课程完成后返回的课程ID(courseId) |
classId | 是 | integer | 课节ID | 课节创建完成后返回的课节ID(classId) |
className | 否 | string | 子课节名称 | 长度不超过50字符 |
teacherUid | 否 | integer | 主讲教师UID(仅主课节) | 仅主课节支持该参数,如需调整子课联席教师请使用assistantUids |
startTime | 否 | integer | 课节开始时间(仅主课节) | 1. Unix Epoch 时间戳(秒单位); 2. 仅主课节支持修改,子课节不支持单独调整,主课修改时会同步调整子课开课时间 3. 可选择未来2年内的时间; |
endTime | 否 | integer | 课节结束时间(仅主课节) | 1. Unix Epoch 时间戳(秒单位); 2. 仅主课节支持修改,子课节不支持单独调整,主课修改时会同步调整子课结束时间 |
assistantUids | 否 | array | 联席教师UID列表 | 不传不修改;示例:[1000082,1000083],UID为integer,不传默认无联席教师 |
cameraHide | 否 | integer | 是否隐藏坐席区,0=显示坐席区,1=隐藏坐席区 | 不传不修改;当cameraHide=1时,isAutoOnstage会始终被设置为1,即不自动上台 |
isAutoOnstage | 否 | integer | 学生进入教室是否自动上台,1=不自动,2=自动 | 不传不修改 |
seatNum | 否 | integer | 上台人数 | 1. 不传不修改; 2. 新双师上台人数与V1版本创建课节API有所区别;此时7=1v6上台;例:传1时,表示1v0,台上只显示老师头像; 3. 传递的台上人数大于配置的最大台上人数,则会被重置为最大台上人数 |
isHd | 否 | integer | 是否高清,0=非高清,1=高清,2=全高清 | 不传不修改;目前仅支持 1v1和1v6, 即seatNum=2或seatNum=7使用 |
isDc | 否 | integer | 双摄模式,是否开启副摄像头,0=不开启,3=开启全高清副摄像头 | 不传不修改;仅支持1v1使用,即seatNum=2 |
useCoMainRecord | 否 | integer | 使用主课节的录课回放;1=使用,0=不使用(仅支持子课使用) | useCoMainRecord为1,会忽略子课关于录课直播相关传值,开启后学生可在客户端观看主课节的录课视频 |
recordType | 否 | integer | 录课类型, 0=录制教室 、1=录制现场、2=两个都录 | 不传不修改;如需修改需要同时传递录课、直播、回放信息,否则不生效;子课修改还需传递useCoMainRecord |
recordState | 否 | integer | 是否开启录课 ,0=关闭, 1=开启 | 不传不修改; 若需要网页直播或者网页回放,则必须选择录课,否则无法开启网页直播、网页回放 |
liveState | 否 | integer | 是否开启直播, 0=关闭,1=开启 | 不传不修改;若需要网页直播,则必须开启录课 |
replayState | 否 | integer | 是否公开回放, 0=关闭,1=开启 | 不传不修改;若需要网页回放,则必须开启录课 |
响应参数
参数名 | 类型 | 示例值 | 含义 |
---|---|---|---|
code | integer | 1 | 错误码 |
msg | string | "程序正常执行" | 错误信息 |
data | array | 课节数据 | 返回信息数组 |
课节数据
参数名 | 类型 | 示例值 | 含义 |
---|---|---|---|
isMainClass | integer | 1 | 是否为主课,1=是,0=否 |
classId | integer | 4157912 | 课节ID |
liveUrl | string | "https://www.eeo.cn/live.php?lessonKey=7a32f568ed7b725c" | 直播回放URL |
liveInfo | object | {} | 直播流信息对象 |
└ FLV | string | "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2.flv?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd" | FLV直播流地址 |
└ HLS | string | "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2.m3u8?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd" | HLS直播流地址 |
└ RTMP | string | "rtmp://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd" | RTMP直播流地址 |
code | integer | 1 | 错误码 |
msg | string | "程序正常执行" | 错误信息 |
示例
- HTTP 请求
POST /lms/onlineDoubleTeacher/editClass HTTP/1.1
Host: root_url
X-EEO-SIGN: 284dab41f025cd7ecd2920575defb189
X-EEO-UID: 2669800
X-EEO-TS: 1732271416
Content-Type: application/json
Content-Length: 357
{
"courseId": 2337435,
"classId": 4157055,
"className": "编辑主课名称+时间",
"startTime": 1732935660,
"endTime": 1732950000,
"teacherUid": 2669800,
"assistantUids": [
1340566
],
"seatNum": 8,
"isHd": 0,
"cameraHide": 0,
"isAutoOnstage": 1,
"liveState": 1,
"openState": 1,
"recordState": 1,
"recordType": 1
}
- Shell cURL 模拟请求指令
curl -X POST \
-H 'Host: root_url' \
-H 'X-EEO-SIGN: 284dab41f025cd7ecd2920575defb189' \
-H 'X-EEO-UID: 2669800' \
-H 'X-EEO-TS: 1732271416' \
-H 'Content-Type: application/json' \
-d '{"courseId": 2337435, "classId": 4157055, "className": "编辑主课名称+时间", "startTime": 1732935660, "endTime": 1732950000, "teacherUid": 2669800, "assistantUids": [1340566], "seatNum": 8, "isHd": 0, "cameraHide": 0, "isAutoOnstage": 1, "liveState": 1, "openState": 1, "recordState": 1, "recordType": 1}' \
'https://root_url/lms/onlineDoubleTeacher/editClass'
响应示例(正常时返回的 json
数据包示例)
{
"code": 1,
"msg": "程序正常执行",
"data": [
{
"isMainClass": 1,
"classId": 4157055,
"liveUrl": "https://www.eeo.cn/live.php?lessonKey=84b978349296b821",
"liveInfo": {
"FLV": "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1f9d918c.flv?txSecret=4cb4e8a5aae291d6df409e97fd6dae8c&txTime=7d8d37cd",
"HLS": "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1f9d918c.m3u8?txSecret=4cb4e8a5aae291d6df409e97fd6dae8c&txTime=7d8d37cd",
"RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1f9d918c?txSecret=4cb4e8a5aae291d6df409e97fd6dae8c&txTime=7d8d37cd"
},
"code": 1,
"msg": "程序正常执行"
},
{
"isMainClass": 0,
"classId": 4157912,
"liveUrl": "",
"liveInfo": {},
"code": 1,
"msg": "程序正常执行"
},
{
"isMainClass": 0,
"classId": 4157913,
"liveUrl": "",
"liveInfo": {},
"code": 1,
"msg": "程序正常执行"
}
]
}
错误码说明
错误码 | 说明 |
---|---|
104 | 未知错误 |
124 | 开课前一分钟内不能更改上课时间 |
136 | 机构下面没有该老师,请在机构下添加该老师 |
140 | 该课节正在上课,不能编辑和删除 |
142 | 该课程下无此单课信息 |
143 | 没有此单课信息 |
144 | 机构下无此课程 |
145 | 该单课已经结束 |
147 | 没有此课程信息 |
153 | 该课程已过期 |
153 | 该课程已过期 |
153 | 该课程已过期 |
165 | 单节课不能少于15分钟且不能超过24小时 |
172 | 课程下的学生不能添加为老师 |
173 | 课程下的旁听不能添加为老师 |
212 | 该单课已经删除 |
212 | 该单课已经删除 |
219 | 老师信息不存在 |
221 | 客户端修改单课视频点播信息失败 |
222 | 客户端修改单课信息失败 |
226 | 未录课的课节不能修改直播回放状态 |
268 | 课节开始时间超出允许范围 |
269 | 课节信息有误,请删除后重新创建 |
318 | 联席教师不是本机构老师 |
318 | 联席教师不是本机构老师 |
319 | 课程下的学生不能添加为联席教师 |
320 | 课程下的旁听不能添加为联席教师 |
322 | 课节老师不能添加为联席教师 |
324 | 联席教师节老师加入教师列表失败 |
325 | 插班生不能添加为老师 |
326 | 联席教师加入教师列表失败 |
328 | 联席教师不能添加为老师 |
350 | 开课前20分钟内不能修改课节名称、上课时间、云盘资源、台上人数等 |
368 | 当前学生上台数不支持高清 |
385 | 已过课节结束时间,不能修改授课教师或联席教师 |
387 | 老师已被停用 |
388 | 联席教师已被停用 |
450 | 数量超出限制 |
451 | 课节直播封面和介绍添加失败 |
451 | 课节直播封面和介绍添加失败 |
454 | 课节起止时间与系统维护时间有重叠 |
767 | 当前版本课节结束时间不允许超过服务期限 |
769 | 教师版或教师试用版,班主任不是本人 |
800 | 老师被停用中 |
804 | 联席教师被停用中 |
808 | 该设置不支持双摄 |
863 | 课节时长不合规定 |
875 | 开课前5分钟内不能修改课节名称、上课时间、云盘资源、台上人数、教室模式等 |
884 | 老师账号已注销 |
885 | 联席教师账号已注销 |
21304 | 非中小学不支持设置学科 |
21305 | 学科不存在 |
21317 | 联席教师数量超出限制 |
21319 | 老师已删除 |
101002005 | 签名异常 |
101002006 | 时间戳过期 |
101002008 | 时间戳不存在 |
121601005 | 不支持设置网页直播 |
121601006 | 不支持设置录制现场 |
121601008 | 不支持设置联席教师 |
121601009 | 不支持设置网页回放 |
121601010 | 不支持设置录制教室 |
121601012 | 清晰度超出限制 |
121601020 | 业务参数错误 |
121601020 | 服务端绑定失败 |
121601021 | 课程不属于当前机构下 |
121601022 | 课程不是标准课 |
121601031 | 课节不属于该机构 |
121601032 | 课节不属于该机构 |
121601033 | 课节处理失败 |
121601034 | 非在线双师课节不支持此操作 |
121601035 | 课节名称长度不能超过50 |
121601036 | 子课节不允许修改授课老师信息和上课时间 |
121601042 | 已结束、已删除课节不支持此操作 |
121601044 | 非本机构老师 |