课中互动拓展方案

ClassIn深耕在线教室多年，经过多年的打磨后，已具备丰富的互动工具。但是机构独有的个性化的互动课件，是否就用不上了呢？其实可以使用ClassIn自己开发的edu文件格式。通过ClassIn在线教室的页面分发能力，在ClassIn展现您的机构自己的web页面，展现自研课件的互动功能，并能ClassIn还能提供用户和课节信息，帮助控制不同角色页面的同步和异步展示。

edu文件制作简单，可以直接在ClassIn教室打开，让老师在授课时可以轻松使用自己机构的个性化H5课件。ClassIn提供在线教室里的页面分发，但具体页面内容需要机构进行开发，以实现师生的个性化互动和互动数据收集。

实现功能

从云盘打开.edu格式的文件，ClassIn能打开该文件指定的页面，该类文件页面内容的同步由机构的平台自行设计，ClassIn仅负责窗口信息（位置、前后关系及全屏状态）的同步。

文件打开后，ClassIn会返回打开文件时相关学校、课程、课节、用户、用户身份等信息，这些信息可协助机构的平台知晓相关信息，可进一步为不同身份的用户展示不同的页面内容，也可将用户操作产生的数据记录到机构的平台。

使用案例

问卷收集

以问卷星为例，可以将想要收集的问卷地址打包入.edu文件，在ClassIn教室内打开，实现收集学生单独提交的问卷。收集完成后，可以在问卷星后台查收问卷收集数据。

问卷星edu

答题器

在教室中，常常通过客观题测验学生对知识的掌握情况。通过使用edu制作的答题器，灵活开展课堂答题，并能及时收集学生答题情况，在课上做针对性讲解和答疑。

答题器edu

互动课件（拖拽、连线、点击等）

如果机构有支持拖拽、连线、点击等互动的课件，可以考虑将其包装为edu文件的方式与学生互动。下面为某机构制作的edu互动课件，在老师页面有丰富的工具以及上课提示，当需要互动时，老师授权给学生操作，学生在老师的引导下完成互动，让课堂高效、有趣。

互动课件edu

抢红包

当节日来临或举办某些活动时，常常需要红包烘托气氛，可以设计抢红包页面，通过edu嵌入ClassIn，与学生互动。

红包雨

结合以上四种案例，可以拓展出无限种互动方案，上课将变得内容更丰富、互动性更强。

edu 文件制作说明

.edu格式内容为一个json，样例如下，key不能改，值可以根据需求调整，数据大小写敏感，使用UTF-8编码。开发者需要保证json格式的正确性，否则上传后会报转换错误，可以使用在线的json校验网站进行检查。请将json内容封装为.edu文件。

{
    "url":"http://www2.bing.com?key=value#anchorHash",
    "uid":true,
    "nickname":true,
    "identity":true,
    "title":"CET4 测试",
    "size":"600x400,300x200",
    "classin_authority":true
}

ClassIn会默认反馈给机构方以下参数：

字段	类型	描述
`schoolId`	64位无符号整数	学校唯一标识号
`courseId`	64位无符号整数	课程唯一标识号
`classId`	64位无符号整数	课节唯一标识号
`initiatorUid`	64位无符号整数	打开该 edu 的用户
`deviceType`	字符串	客户端类型，取值范围是`pc`,`android`,`iPhone`,`iPad`
`lang`	字符串	客户端语言，取值范围是`en`(英语),`zh-CN`(简体中文),`zh-TW`(繁体中文),`es`(西班牙语)

edu文件选填项：

字段	类型	取值／默认值	描述
`uid`	bool	`true`, `false`	`true`表示在classin 打开edu文件时返回`uid=<登录者的uid>`
`nickname`	bool	`true`, `false`	`true`表示 classin 打开edu文件时返回`nickname=<登录者的nickname>`
`identity`	bool	`true`, `false`	`true`表示 classin 打开edu文件时返回`identity=<登录者的角色>` 角色范围是`teacher`, `assistant`, `student`, `auditor`
`title`	string		课件标题栏会显示此字符串
`classin_authority`	bool	`true`, `false`	`true`表示由老师在ClassIn教室里通过摄像头下方的授权按钮控制 edu 文件是否响应用户操作，`false` 表示网页内容一直是可操作的状态。注：auditor 角色永远没有权限操作edu
`size`	string	`"600x400,300x200"`	值为两组宽高，第一组是打开时窗口的推荐大小，第二组是窗口的最小限制。注：两组大小均不能小于 100x0，且推荐大小不能小于最小限制。宽高之间使用小写字母x分隔，两组宽高之间使用半角逗号`,`分隔

注意事项

开发时请注意不要在发布环境中弹独立的窗口（如alert），否则接收端可能会闪退。保留 alert弹窗仅作为开发阶段调试使用。如果需要弹窗的话，发布环境中应该在ClassIn的edu课件框内显示提示框。

ClassIn使用的浏览器

PC版: Chromium Embedded Framework (84.4.0+g304e015+chromium-84.0.4147.105)，可使用这里的浏览器工具进行调试
iOS版: 手机/Pad系统自带的Safari
Android版：手机/Pad系统自带的浏览器

课中互动拓展方案

实现功能​

使用案例​

问卷收集​

答题器​

互动课件（拖拽、连线、点击等）​

抢红包​

edu 文件制作说明​

ClassIn会默认反馈给机构方以下参数：​

edu文件选填项：​

注意事项​

ClassIn使用的浏览器​