编辑在线双师课节

接口功能: 修改在线双师主子课节的主讲教师、助教、时间等信息

接口说明:

  • 此接口仅支持修改在线双师主子课节
  • 主课节修改主讲教师、时间时会同步修改子课节
  • 子课节不允许修改主讲教师、时间
  • 此接口支持仅传递需修改的参数,可传一个或多个;全都不传,报【参数不全】错误
  • 子课节如果需要修改录课直播回放,需同时传递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 非本机构老师

results matching ""

    No results matching ""