实时互动-教育版课堂生命周期说明

课堂状态说明
实时互动-教育版会有以下几种课堂状态：
说明：
您可通过获取 房间配置信息 接口查询课堂状态。
课堂状态
参数值
说明
未开始
Status=0
还未到预约上课时间，且老师（或助教）没有点击开始上课。此时支持情况如下：
老师（或助教）和学生均可以：
上课前设备检测、网络检测。
发送互动消息。
设置虚拟背景。
仅老师（或助教）可以：
查看当前到课人数。
上传课件。
发布公告。
查看学生列表。
使用白板工具（效果不会同步学生侧）。
进行上课前其他设置（如是否显示学生举手、进出情况等）。
开始上课
﻿
Status=1
正式上课。开始统计课堂时长。
此时，老师（或助教）、学生均可以：
音视频功能。
白板（涂鸦、展示课件、屏幕共享等）。
发送互动消息等。
结束课堂
Status=2
结束课堂。结束统计课堂时长。
课堂过期
Status=3
没有开课，当前已过下课时间。
切换课堂状态
正式上课时，统计“实际房间开始时间”。以下情况会正式上课：
类型
说明
用户行为
未到预约上课时间，老师（或助教）提前进入房间，点击开始上课。
﻿
到了预约上课时间，老师（或助教）点击开始上课。
云 API 接口控制
通过 开始直播 接口，正式上课。
结束课堂时，统计“实际房间结束时间”。以下情况对应正式下课：
类型
说明
在预定的课堂结束时间EndTime之前。
说明：该字段见 创建课堂 。
老师（或助教）操作下课。
﻿创建课堂 中EndDelayTime设置不限制拖堂时间。
注意：该字段非必填。课堂默认为不限制拖堂时间。
到了预约下课时间，老师（或助教）操作下课。
﻿
到了预约下课时间，且没有成员在线，自动结束课堂。房间内仍有成员在线时，会持续上课。
注意：为避免影响正常上课，预约下课时间5分钟后，校验是否有成员在线。
﻿创建课堂 中EndDelayTime设置不能拖堂时间。
到预约下课时间（无论课堂内是否有成员在线），自动结束课堂。
﻿创建课堂 中EndDelayTime设置拖堂时间。
根据设置的拖堂时间，自动结束课堂。
云 API 接口控制
通过 结束直播 接口，正式下课。
伪直播推流结束，自动结束课堂。
-
RTMP 推流课程
需设置拖堂时间，或在推流结束后调用 结束直播，及时结束课堂
说明：
﻿创建课堂 预定开始至预定结束时间不得超过24小时。
针对开课持续时长超过24小时的课程，会启动自动结束机制，以避免超长课程带来不必要的资源消耗。
统计课堂时长
课堂时长 = 实际房间结束时间 - 实际房间开始时间。
您可以通过 获取房间统计信息，查询课堂实际开始和实际结束时间，参见 RealStartTime 和 RealEndTime。

课堂状态	参数值	说明
未开始	`Status`=0	还未到预约上课时间，且老师（或助教）没有点击开始上课。此时支持情况如下：老师（或助教）和学生均可以：上课前设备检测、网络检测。发送互动消息。设置虚拟背景。仅老师（或助教）可以：查看当前到课人数。上传课件。发布公告。查看学生列表。使用白板工具（效果不会同步学生侧）。进行上课前其他设置（如是否显示学生举手、进出情况等）。
开始上课	`Status`=1	正式上课。开始统计课堂时长。此时，老师（或助教）、学生均可以：音视频功能。白板（涂鸦、展示课件、屏幕共享等）。发送互动消息等。
结束课堂	`Status`=2	结束课堂。结束统计课堂时长。
课堂过期	`Status`=3	没有开课，当前已过下课时间。

类型	说明
用户行为	未到预约上课时间，老师（或助教）提前进入房间，点击开始上课。
用户行为		到了预约上课时间，老师（或助教）点击开始上课。
云 API 接口控制	通过开始直播接口，正式上课。

类型	说明
在预定的课堂结束时间`EndTime`之前。说明：该字段见创建课堂。	老师（或助教）操作下课。
创建课堂中`EndDelayTime`设置不限制拖堂时间。注意：该字段非必填。课堂默认为不限制拖堂时间。	到了预约下课时间，老师（或助教）操作下课。
创建课堂中`EndDelayTime`设置不限制拖堂时间。注意：该字段非必填。课堂默认为不限制拖堂时间。		到了预约下课时间，且没有成员在线，自动结束课堂。房间内仍有成员在线时，会持续上课。注意：为避免影响正常上课，预约下课时间5分钟后，校验是否有成员在线。
创建课堂中`EndDelayTime`设置不能拖堂时间。	到预约下课时间（无论课堂内是否有成员在线），自动结束课堂。
创建课堂中`EndDelayTime`设置拖堂时间。	根据设置的拖堂时间，自动结束课堂。
云 API 接口控制	通过结束直播接口，正式下课。
伪直播推流结束，自动结束课堂。	-
RTMP 推流课程	需设置拖堂时间，或在推流结束后调用结束直播，及时结束课堂

课堂生命周期说明

本页目录：

课堂状态说明

切换课堂状态

统计课堂时长