# 文档版本：v_1.0.0
# 写在前面

根据需要对接的平台，工程师务必完成下面所述各项准备工作并明确所需登录方式以及蓝牙支持情况，否则项目无法顺利进行。

# 准备工作

### 微信公众号嵌入仪器控H5

##### 环境准备

1. 需要域名
2. 需要学校开放外网访问大仪域名，可一直开放或在做域名验证时开放半天或一天时间

##### 公众号准备

###### 1. 公众号管理后台地址

https://mp.weixin.qq.com/
扫码后请选择公众号进行登录

###### 2.确保学校已注册公众号并完成微信认证

![alt text](image.png)

###### 3.添加基理开发人员为公众号开发者或找专门老师配合

工程师尽量引导老师添加基理开发人员为公众号开发者，开发可自己进行后续 4、5、6 的操作，否则需要老师操作，沟通成本较高。但部分学校管理比较严格，不能添加基理开发人员为公众号开发者的话，需要联系一个专门配合的老师，开发可联系老师进行后续操作。

公众号后台添加开发人员的位置如下图，开发需提供给老师手机号，老师即可进行添加

![alt text](image-3.png)

###### 4.设置业务域名和网页授权域名

![alt text](image-1.png)

点击设置弹窗会弹窗提示，按照提示将.txt 文件提供给开发，开发部署完成后，需要老师填写域名并点击保存。此过程中要求学校开放大仪域名的外网访问，学校可能需要做二级等保，所以要提前和老师说。

![alt text](image-2.png)

###### 5.将AppID、AppSecret提供给开发

![alt text](image-17.png)

###### 6.上线后设置自定义菜单

确认无问题并正式上线后，老师可进入微信公众号后台自行添加到公众号菜单
![alt text](image-4.png)

### 企业微信嵌入仪器控H5

##### 环境准备

1. 需要域名
2. 需要学校开放外网访问大仪域名，可一直开放或在做域名验证时开放半天或一天时间

##### 企业微信准备

###### 1. 企业微信管理后台地址

https://work.weixin.qq.com/
如学校为定制企业微信，则由学校自己提供后代地址

###### 2.测试账号

工程师应联系老师添加基理开发人员手机号到学校的企业微信，方便开发测试。
如学校不愿添加，需提供一位老师的企业微信供开发测试用。

###### 3.添加基理开发人员为企业微信开发者或找专门老师配合

工程师尽量引导老师添加基理开发人员为企业微信开发者，开发可自己进行后续 4、5、6、7 的操作，否则需要老师操作，沟通成本较高。但部分学校管理比较严格，不能添加基理开发人员为企业微信开发者的话，需要联系一个专门配合的老师，开发可联系老师进行后续操作。

开发需提供给老师手机号，老师即可进行添加

###### 4.确保学校已添加企业微信应用

名称：仪器共享
链接：域名/fridayh5
图标：可由学校提供或找开发要一个默认图标

![alt text](image-5.png)

###### 5.设置网页授权及 JS-SDK

![alt text](image-6.png)

点击设置弹窗会弹窗提示，按照提示将.txt 文件提供给开发，开发部署完成后，需要老师填写域名并点击保存。此过程中要求学校开放大仪域名的外网访问，学校可能需要做二级等保，所以要提前和老师说。

![alt text](image-7.png)

###### 6.设置企业可信 ip

![alt text](image-8.png)

###### 7.将AgentId、Secret、企业ID提供给开发
![alt text](image-15.png)
![alt text](image-16.png)

### 微信小程序嵌入仪器控H5

##### 环境准备

1. 需要域名
2. 需要https证书
2. 需要学校开放外网访问大仪域名，可一直开放或在做域名验证时开放半天或一天时间

##### 小程序准备

###### 1. 小程序管理后台地址

https://mp.weixin.qq.com/
扫码后请选择小程序进行登录

###### 2.确保学校已注册小程序并完成微信认证和小程序备案
![alt text](image-11.png)


###### 3.添加基理开发人员为小程序开发者或找专门老师配合

工程师尽量引导老师添加基理开发人员为小程序开发者，开发可自己进行后续 4、5 的操作，否则需要老师操作，沟通成本较高。但部分学校管理比较严格，不能添加基理开发人员为小程序开发者的话，需要联系一个专门配合的老师，开发可联系老师进行后续操作。

公众号后台添加开发人员的位置如下图，开发需提供给老师手机号，老师即可进行添加

![alt text](image-10.png)

###### 4.设置业务域名和网页授权域名

![alt text](image-12.png)

点击设置弹窗会弹窗提示，按照提示将.txt 文件提供给开发，开发部署完成后，需要老师填写域名并点击保存。此过程中要求学校开放大仪域名的外网访问，学校可能需要做二级等保，所以要提前和老师说。

![alt text](image-13.png)

###### 5.将AppID、AppSecret提供给开发
![alt text](image-14.png)

# 关于登录方式

###### 1.本地登录

简介：输入 lims 账号密码即可登录，该登录方式也是其他登录方式登录不成功后的默认登录方式。

对接平台要求：【无】

###### 2.统一身份认证登录

简介：如果大仪对接了学校的统一身份认证登录，H5 也可调用大仪链接实现统一身份认证登录，如大仪未对接统一身份认证登录则 H5 无法提供该登录方式。

工程师需向开发提供统一身份认证账号密码

对接平台要求：【无】

###### 3.企业微信认证免登录

简介：通过调用企业微信 api 获取用户的学工号并进行登录。该方式要求确保学校已将学工号绑定到企业微信，否则无法实现该登录方式。

工程师需向开发提供统老师企业微信或添加开发手机号到学校企业微信，用于测试。

对接平台要求：【企业微信】

###### 4.微信扫码绑定登录

简介：使用微信扫描大仪的绑定二维码，将微信个人信息与大仪用户信息进行绑定，实现免登录。

对接平台要求：【微信公众号】

###### 5.其他登录方式

除了上述 4 种方式，其他登录方式一般都需要额外开发，例如：学校有自己的 app，要求将大仪 H5 嵌入其 app 内，实现免登录。这部分需要与学校对接，需要额外开发。

# 设备能力支持

| 对接方式   | 扫码 | 蓝牙 |
| ---------- | ---- | ---- |
| 微信公众号 | 是   | 否   |
| 企业微信   | 是   | 是   |
| 微信小程序 | 是   | 是   |

# 仪器控 H5 线上访问地址

学校域名/fridayh5
如：http://gxpt.whu.edu.cn/fridayh5
