【v4版】考试系统人脸核身功能使用说明

申请时，统一要求：

1.选 Plus版人脸核身，选择权威库；2.不配置身份证OCR；3.不配置意愿页面。

一、功能概述

人脸核身功能集成腾讯云人脸核身（FaceID）服务，为考试系统提供安全验证能力，包含三种模式：

1. 严格模式
   进入考试前调用腾讯云人脸核身进行实名比对，考试过程中随机拍照并调用接口进行比对（中途比对如果不通过，不中断考试，只记录档案给管理员后台查阅，作为作弊有参考）。
2. 入口核验模式
   进入考试前用腾讯云人脸核身进行实名比对，考试过程随机拍照但不调用接口比对。
3. 仅拍照模式
   不调用腾讯云接口，仅在考试过程中随机拍照存档，节省费用。

人脸核身功能集成腾讯云人脸核身（FaceID）和人脸识别（IAI）服务，为考试系统提供安全验证能力，支持三种核验模式：

模式说明：

1. 严格模式
   进入考试前需完成腾讯云人脸核身；考试过程中随机弹出拍照，系统自动调用腾讯云 IAI CompareFace 接口将中途拍照与入口核身照片进行人脸比对；比对通过标记"通过"，比对未通过（相似度低于70%）标记"比对未通过"并提示考生，但不会强制交卷或中断考试；管理员可在后台查看所有比对结果和相似度分数
2. 入口核验模式
   进入考试前需完成腾讯云人脸核身；考试过程中随机弹出拍照仅存档不比对；需在系统配置中设置腾讯云人脸核身参数
3. 仅拍照模式
   进入考试前无需人脸核身；考试过程中随机弹出拍照仅存档；不调用人脸比对接口，节省费用

二、腾讯云服务申请

2.1 开通服务

1. 登录 腾讯云控制台，完成账号实名认证
2. 进入 人脸核身产品页，点击"立即使用"开通服务
3. 开通后进入 人脸核身控制台

2.2 获取 API 密钥

1. 访问 API密钥管理
2. 点击"新建密钥"，获取 SecretId 和 SecretKey
3. 如果系统已配置 COS 存储的密钥，人脸核身可共用同一套密钥，无需单独填写

2.3 创建业务流程（RuleId）

系统支持多种渠道，不同渠道需创建对应的 RuleId：

微信原生H5 vs 微信浮层H5 如何选择？

• 微信原生H5
  核身流程在微信原生界面中完成，体验更好、安全性更高，但有行业资质限制（如金融、政务、医疗等），审核需3-5个工作日，且需公众号管理员扫码授权
• 微信浮层H5
  核身流程在H5浮层中完成，无行业限制，审核快，兼容性好（不兼容时自动降级为普通H5）。如不满足原生H5资质要求，推荐使用浮层H5

创建步骤：

1. 登录人脸核身控制台 → 自助接入 → 创建业务流程

1. 选择应用场景

• 微信小程序选"微信小程序"
• 微信公众号（原生体验）选"微信原生H5"
• 微信公众号（浮层模式）选"微信H5（浮层/普通模式）"
• 移动端和PC端选"移动H5"

1. 选择应用类型
   推荐选 Plus版人脸核身（支持浮层模式，体验更好）
2. 是否需要在微信外打开
   微信浮层H5渠道建议选"是"，这样一个RuleId可同时兼容微信内外场景
3. 填写接入配置
   页面标题、业务名称、业务描述等（按实际填写）
4. 选择人脸比对库源

• 跟权威库比对
  用户人脸与公安权威库身份证照片比对，需用户输入姓名+身份证号，准确率最高
• 跟上传照片比对
  用户人脸与系统上传的照片比对，无需身份证号

1. 配置身份证OCR
   如不需要可跳过
2. 配置活体检测
   推荐选"一闪活体"（眨眼+光线检测）
3. 配置意愿页面
   考试场景一般不需要意愿确认，跳过即可
4. 确认提交
   审核通过后系统分配 RuleId（格式如 1、2 等数字）

注意：微信浮层H5无行业限制，审核较快；微信原生H5和微信小程序有行业资质要求，审核需3-5个工作日。

三、系统配置

3.1 后台配置路径

管理后台 → 系统设置 → 人脸核身

3.2 配置项说明

RuleId回退机制：系统按以下优先级查找RuleId：

• 微信小程序：小程序SDK RuleId → 默认RuleId
• 微信公众号H5：公众号H5 RuleId → 小程序SDK RuleId → 默认RuleId
• 移动端：移动端 RuleId → 公众号H5 RuleId → 小程序SDK RuleId → 默认RuleId
• PC端：PC端 RuleId → 默认RuleId

3.3 配置示例

SecretId: AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxSecretKey: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx默认RuleId: 1小程序SDK RuleId: 2公众号H5 RuleId: 3移动端 RuleId: 4PC端 RuleId: 4回调地址: （留空）

如果移动端和PC端使用相同的RuleId，可以只填"移动端 RuleId"，"PC端 RuleId"留空，然后在"默认RuleId"中填写同一个值。

如果只配置了一个微信渠道的RuleId（如只有"公众号H5 RuleId"），则微信小程序和移动端会自动回退使用该RuleId。

3.4 config.yaml 配置

也可以直接在 config.yaml 中配置：

faceid:    secret_id: ''    secret_key: ''    rule_id: '1'    rule_id_wx: '2'    rule_id_wx_h5: '3'    rule_id_mobile: '4'    rule_id_pc: '4'    redirect_url: ''

四、考场启用

1. 进入 考试管理 → 考场管理
2. 编辑或创建考场时，勾选 "开启安全核验"
3. 选择核验模式（三选一）：

• 严格模式
  入口人脸核身 + 中途拍照比对。进入考试前需完成腾讯云人脸核身；考试过程中随机弹出拍照，与入口照片进行人脸比对；比对未通过仅标记不中断考试；需在系统配置中设置腾讯云人脸核身参数
• 入口核验模式
  入口人脸核身 + 中途拍照仅存档不比对。进入考试前需完成腾讯云人脸核身；考试过程中随机弹出拍照仅存档不比对；需在系统配置中设置腾讯云人脸核身参数
• 仅拍照模式
  不核验身份，全程仅拍照存档。进入考试前无需人脸核身；考试过程中随机弹出拍照仅存档；不调用人脸比对接口，节省费用

1. 配置核验参数：

• 拍照间隔
  随机拍照的时间间隔（60-1800秒），默认300秒（5分钟）
• 随机偏移
  勾选后在设定间隔上增加随机偏移，防止考生预判核验时间

五、用户考试流程

5.1 严格模式（strict）

1. 用户点击"开始考试"
2. 系统检测到考场启用了严格模式核验，弹出核身提示
3. 根据用户所在平台，系统自动选择核身方式：

• 微信小程序
  调用小程序SDK（wx.startVerify）进行原生核身，核身完成后自动回调
• 微信公众号H5
  跳转到腾讯云核身页面，用户完成核身后自动跳回系统。如配置了"微信原生H5"的RuleId，将使用微信原生核身体验；如配置了"微信浮层H5"的RuleId，将使用浮层模式
• 移动端浏览器
  跳转到腾讯云核身H5页面，完成后跳回
• PC端
  弹出新窗口打开核身页面，核身通过后自动进入考试

1. 核身通过后，有效期与考试时长一致（优先使用考场时间范围，其次使用试卷时长，最小30分钟兜底），超时需重新核验
2. 进入考试后，系统按设定间隔随机弹出拍照核验
3. 每次拍照后，系统自动调用腾讯云 IAI CompareFace 接口，将当前照片与入口核身照片进行比对
4. 比对结果：

• 通过
  （相似度 ≥ 70%）：提示"核验通过"，继续考试
• 未通过
  （相似度 < 70%）：提示"人脸比对未通过"，但不会强制交卷或中断考试，管理员可在后台查看
• 比对异常
  （接口调用失败等）：标记为"比对异常"，继续考试

5.2 入口核验模式（entry_only）

1. 用户点击"开始考试"
2. 系统检测到考场启用了入口核验模式，弹出核身提示
3. 核身流程同严格模式步骤3-4
4. 进入考试后，系统按设定间隔随机弹出拍照提示
5. 用户拍照后照片自动上传保存，不进行人脸比对，仅存档

5.3 仅拍照模式（photo_only）

1. 用户点击"开始考试"，直接进入考试（无需人脸核身）
2. 考试过程中系统按设定间隔随机弹出拍照提示
3. 用户拍照后照片自动上传保存，不进行人脸比对

H5端说明：H5端拍照时可从相册选择照片，核验可被绕过，这是浏览器兼容性限制，无法在H5端强制调用摄像头。如需更高安全性，建议使用微信小程序端。

六、核验记录查看

1. 进入 考试管理 → 考场管理
2. 找到开启了安全核验的考场，点击 "核验照片" 按钮
3. 可查看该考场所有考生的核验照片、比对结果、相似度分数
4. 管理员可勾选多条记录后点击"删除"按钮批量删除核验记录
5. 考试记录导出PDF时，核验照片会附在PDF底部（每行3张）

核验结果状态说明

七、费用说明

具体价格以 腾讯云人脸核身计费 和 人脸识别计费 为准。

费用估算示例：严格模式下，一场60分钟的考试，入口核身1次 + 每5分钟随机拍照1次约12次比对，总费用约 1.3 + 12×0.15 = 3.1元/人。

答题自动保存策略

八、常见问题

Q: 微信小程序审核时提示需要隐私权限怎么办？A: 系统已做兼容处理，当未配置腾讯云参数或未开启考试开关时，人脸核验页面显示"未开启"状态，不会调用摄像头组件。

Q: PC端支持哪些浏览器？A: PC端仅支持 Chrome 87+ 和 Firefox 45+ 版本。

Q: 核身结果保留多久？A: 腾讯云侧核身结果仅保留3天，系统会在核身完成时自动拉取并保存到本地数据库。入口核身有效期与考试时长一致（优先使用考场设定的结束时间-开始时间，其次使用试卷时长，最小30分钟兜底）。

Q: 一个RuleId能否多渠道通用？A: 不同渠道的RuleId不能混用。微信小程序、微信原生H5、微信浮层H5、移动H5各自对应不同的应用场景，需分别创建。微信浮层H5创建时选择"是否需要在微信外打开=是"，则该RuleId可同时兼容微信内外场景，但仍不能用于小程序。

Q: 公众号H5应该选"微信原生H5"还是"微信浮层H5"？A: 如果您的公众号主体符合行业资质要求（金融、政务、医疗等），推荐选"微信原生H5"，体验更好、安全性更高；如不满足资质要求，选"微信浮层H5"即可，无行业限制，审核快。

Q: 只配置了一个RuleId，其他渠道能用吗？A: 系统有RuleId回退机制。例如只配置了"公众号H5 RuleId"，则微信小程序会回退使用该RuleId，移动端也会回退使用。但建议为不同渠道分别配置对应的RuleId以获得最佳体验。

Q: 旧版本已配置在微信tab下的人脸核身配置会丢失吗？A: 不会。系统已做兼容迁移，首次加载时会自动将旧的 wechat.faceid 配置迁移到新的独立 faceid 配置中。

Q: 严格模式下人脸比对未通过会怎样？A：比对未通过时系统会提示考生"人脸比对未通过，请保持面部正对摄像头"，但不会强制交卷或中断考试。比对结果（包括相似度分数）会记录到核验照片记录中，管理员可在后台查看并人工审核。建议管理员在考试结束后对"比对未通过"的记录进行复核。

Q: 旧版本考场配置的"仅拍照模式"如何迁移？A：系统已做兼容处理。旧版本 faceVerifyPhotoOnly: true 的考场会自动映射为 faceVerifyMode: "photo_only"，旧版本 faceVerifyPhotoOnly: false 的考场会自动映射为 faceVerifyMode: "strict"。无需手动修改。

Q: H5端拍照能否强制使用摄像头？A：不能。H5浏览器无法兼容强制调用摄像头，拍照时可从相册选择照片。如需更高安全性，建议使用微信小程序端，小程序端通过 wx.startVerify 进行原生核身，安全性更高。