唤醒 ClassIn 客户端的最佳实践

注意： 由于微信小程序相关限制，目前不支持在微信小程序中唤醒 ClassIn。

ClassIn 提供唤醒客户端并进入教室的解决方案，适用于您的平台拥有自己的用户页面或 APP 的场景。

相关接口文档： 获取登录跳转链接

三种唤醒方式

方式一：原生唤醒链接直接进入教室

通过原生协议链接直接拉起 ClassIn 客户端并进入教室。若设备未安装 ClassIn，点击链接不会有任何响应。

效果预览：

方式二：通过中间提示页唤醒（推荐）

中间页会检测设备是否已安装 ClassIn：已安装则提示打开客户端，未安装则引导用户下载。适用于 PC 端和移动端，是兼容性最好的方案。

中间页地址：

https://www.eeo.cn/client/invoke/index.html

使用时将接口返回的参数拼接到中间页地址后面即可：

<!-- 仅唤起客户端，不进入特定教室 -->
<a href="https://www.eeo.cn/client/invoke/index.html">打开 ClassIn</a>

<!-- 唤起客户端并直接进入教室 -->
<a href="https://www.eeo.cn/client/invoke/index.html?telephone=12345678901&classId=1213545&courseId=394761&schoolId=1009478">进入教室</a>

效果预览： 中间页唤醒示例

说明： iOS 移动端通过接口返回的链接默认已嵌入中间页。

方式三：唤起客户端并进入 LMS 课程活动页

唤起客户端后直接跳转至指定课程的 LMS 活动列表，方便师生快速使用 LMS 功能。

拼接规则：

classin://www.eeo.cn/enterclass?autoCourseId=<班级ID>

注意： 需将 ClassIn 更新至 5.2.1 及以上版本，不支持从微信内唤起。

各端唤醒说明

iOS 端

H5 页面唤醒

iOS 默认带中间页，支持直接在微信内唤起 ClassIn。若设备未安装，会引导用户跳转到浏览器，并根据提示前往 App Store 下载。

第三方 APP 内唤醒

场景	方式
不显示中间页，直接唤起	使用 [UIApplication sharedApplication] 打开中间页跳转链接
在 APP 内唤起，不跳浏览器	使用 WebView 打开中间页链接，将 UA 设置为 Safari

Android 端

Android 端默认无中间页，不支持在微信内直接唤醒 ClassIn。

原生协议（classin://）：将链接绑定到页面按钮触发唤起；微信内打开无效，建议配合中间页方案使用。
中间页：需跳转浏览器或使用内置 WebView 打开，将唤醒参数拼接在中间页地址后面。

PC 端

原生协议（classin://）：通过接口获取跳转链接后可直接实现跳转。
中间页：将唤醒参数拼接在中间页地址后面即可。

微信公众号

推荐使用中间页唤醒方案。将参数拼接到中间页地址后跳转，用户会从微信跳转至设备自带浏览器，再由浏览器唤起 ClassIn 客户端。

注意： 此方式无法从微信内直接跳转至 ClassIn，需要借助系统浏览器中转。

唤醒ClassIn客户端的最佳实践