消息订阅说明

数据记录项

为了更好的统计教师和学生的课堂行为,EEO Hamster服务将教师和学生在教室内的行为实时记录下来,并且对这些行为分门别类。目前,我们记录了如下教室数据:

数据类型 数据维度 推送时机 备注
举手 课节 课节内实时推送 以个人为单位统计举手次数和时间。如果举手放下的间隔时间较短,则单次举手时间可能为0
奖励 课节 课节内实时推送 以个人为单位统计奖励次数
摄像头位置 课节 课节内实时推送
授权 课节 课节内实时推送
进入教室 课节 课节内实时推送
退出教室 课节 课节内实时推送
踢出 课节 课节内实时推送
全体静音 课节 课节内实时推送
个人静音 课节 课节内实时推送
答题器 课节 课节内实时推送
抢答器 课节 课节内实时推送
上下台 课节 课节内实时推送 以个人为单位统计上下台次数以及台上台下时间,如果进入教室就在台上,整节课都在教室内,并且没有被下台,则上台次数为1,台上时间为在课节时间
教室内IM文字聊天 课节 课节内实时推送 用户在教室IM聊天室发送的文字和表情
教室内IM图片聊天 课节 课节内实时推送 用户在教室IM聊天室里发送的图片信息
课节网络状态 课节 课节内实时推送 课节实时网络与CPU占用率状态反馈,每5分钟发送一次,为5分钟内的汇总信息
教室内设备检测 课节 课节内实时推送 用户在教室内的设备检测信息,包括:操作系统,CPU,网络延迟,丢包率,用户选择的麦克风名称和状态,用户选择的耳机名称和状态,用户选择的摄像头名称和状态,用户所有所有麦克风&耳机&摄像头&设备名称列表,客户端IP地址,客户端软件版本,Mac地址
教室内老师和学生求助 课节 课节内实时推送 上课过程中,老师端和学生端(需要在机构管理后台的 教室配置 里勾选),都能够向sdk管理后台发起求助信息
延长课节时长 课节 课节内实时推送 课节结束前 8 - 3 分钟内,如果老师延长课节时长,将实时收到此推送消息
直播页面用户登录 课节 课节内实时推送 直播过程中,登录直播页面的用户信息
启动录课详情 课节 课节内实时推送 每次录课启动时推送
课后汇总数据 课节 课节结束后(含20分钟拖堂时间)推送
课节教师和学生评价和评分 课节 课节结束后(含20分钟拖堂时间)推送 老师或学生退出教室,对课节的评价和评分信息
课后生成的录课文件 课节 课节结束后(含20分钟拖堂时间)推送 课节结束后,推送课节录制的视频文件信息
课后上传回放视频 课节 课节结束后(含20分钟拖堂时间)推送 用户可以通过sdk机构管理后台(入口:课程管理 - 课节操作菜单下的“录课视频数据”)手动上传课节回放视频片段,文件上传完毕会收到此推送消息
多人多题EDU答题信息 课节 课节结束后(含20分钟拖堂时间)推送 多人多题的答题统计信息
文件转换结果 机构 转换完成后实时推送 机构账号上传的文件的转换结果
教室外设备检测 机构 用户完成检测后实时推送 用户在教室外的设备检测信息,包括:操作系统,CPU,网络延迟,丢包率,用户选择的麦克风名称和状态,用户选择的耳机名称和状态,用户选择的摄像头名称和状态,用户所有所有麦克风&耳机&摄像头&设备名称列表,客户端IP地址,客户端软件版本,Mac地址
用户修改昵称 机构 用户修改完成后实时推送 机构下的用户修改昵称后,推送新昵称信息

更加详细的描述,请见API文档相关章节:

数据推送规则

  1. 实时推送POST;
  2. 数据统计服务会保证接收方接收数据的可靠性,如果发送或者接收失败,会反复重试,直到成功。
  3. 接收方成功接收数据后需返回如下json格式的应答,服务收到应答后,不再尝试重发。
{
  "error_info": {       
    "errno": 1,// 1表示接收方正常接收,其他码表示出错
    "error": "程序正常执行"     //此字段只作信息参考,不用来判断是否接收成功
  }
}

如何获取数据

  1. 机构需要提供回调接口地址,来接收数据统计服务实时发送的数据。
  2. 机构注册回调接口地址时,需要先进行测试,数据统计服务会向注册地址发送如下测试数据

     {
         "SID": "SID",
         "Cmd": "Test",
         "Msg": "Register test.",
         "SafeKey": "String", //机构认证安全密钥md5(SECRET + TimeStamp)
         "TimeStamp": "123"    //机构认证时间戳
     }
    
  3. 机构回复成功应答后,测试通过完成。

常见问题Q&A

  1. 收到回调通知,但取不到回调数据

    回调通知数据内容是以raw json的形式发送,不是以表单的形式;

    Postman实例

  2. 接口测试收到报错10003

    回调接口收到通知后需要回复正确的应答,此错误表明应答数据格式错误,可能不是json,或json中的字段不正确。

results matching ""

    No results matching ""