人脸识别设备
人脸识别设备是接入 Vittor 的外部硬件，用于在现场采集画面并执行人脸比对。系统向设备同步人员资料，接收设备心跳和识别事件，再用于管理查询或大屏展示。
设备在线、人员已同步、能够正确识别是三项独立检查。建议先接通一台设备和一名测试人员，再按相同配置扩展到其他现场设备。
接入前准备
请由设备供应商或实施人员确认以下资料，使用受控的现场配置单保存认证信息。
| 项目 | 需要确认的内容 |
|---|---|
| 硬件与固件 | 设备型号、固件版本、支持的协议版本 |
| 设备标识 | 系统中使用的唯一设备 SID，避免不同设备共用标识 |
| 网络 | 设备地址、服务地址、必要端口，以及双方实际可达性 |
| 同步方式 | 服务端主动推送，或设备主动拉取人员变更 |
| 事件去向 | 直接上传中心服务，或直接上传大屏本地接口 |
| 安装用途 | 对应楼栋、设备组和出入方向等现场配置 |
| 认证 | 该设备协议要求的账户、密码或密钥 |
系统支持的设备型号和固件并非都能即插即用。选型和新增接入应以协议对照及现场联调结果为准。
配置与验证顺序
1. 接通网络和心跳
为设备设置约定的上传地址和认证信息。确认系统接收端能够看到该设备的最近心跳，并核对设备 SID 与现场标签对应。没有心跳时，先排查电源、网络、端口、地址和协议配置。
Web“系统配置”中的节点列表主要用于发现服务端、录入端和大屏端。外接识别设备是否在线，应以其实际接入链路的设备心跳为准。
2. 同步一名测试人员
在服务端准备一名资料与照片完整的测试人员，确认关联到目标设备或设备组。等待同步处理后，在设备侧查到相同人员标识，并确认照片可用。
保存人员资料会先产生同步工作，完成时间取决于队列、协议和设备响应。设备有心跳但没有该人员时，继续查看任务状态和设备返回信息。
3. 完成真实识别
使用已同步人员在设备前完成识别。核对设备结果，再检查中心服务或大屏接收端是否收到本次事件，确认人员、设备标识和事件时间一致。
如果需要用于出入和未归统计，还要分别验证对应方向的事件与人员状态变化；大屏出现照片本身不足以证明出入统计正确。
4. 验证人员变更
对测试人员执行一次需要验收的资料或照片更新，并核对设备侧结果。如本次交付包含删除同步，应使用专用测试人员验证删除结果，避免操作真实在用人员。
接入验收清单
| 检查项 | 通过标准 |
|---|---|
| 心跳 | 接收端能持续看到正确设备的最近心跳 |
| 人员新增 | 设备存在该测试人员，标识与照片一致 |
| 人员更新 | 修改后的资料或照片在设备侧生效 |
| 人员删除（按交付范围） | 测试人员删除任务完成，设备侧结果可确认 |
| 识别回传 | 接收端能够查到本次测试事件 |
| 大屏展示 | 正确模式下显示同一事件的人、设备和时间 |
| 出入状态（按交付范围） | 进出方向与管理端人员状态符合现场规则 |
常见问题
| 现象 | 排查顺序 |
|---|---|
| 从未在线 | 电源与网络 → 上传地址 → 端口 → 协议和认证 |
| 在线但没有人员 | 服务端人员 → 设备关联 → 同步队列 → 设备返回 → 设备人员记录 |
| 识别成功但没有事件 | 设备上传配置 → 接收端日志 → 事件响应 → 大屏模式或中心回调 |
| 姓名或照片不一致 | 人员唯一标识 → 已有设备人员 → 最近更新任务 |
| 时间或出入状态不对 | 设备时间与时区 → 事件时间 → 出入方向配置 → 人员房间关系 |
排查时记录测试时间、设备标识、人员测试标识和错误消息。不要通过批量删除设备人员或重置设备来试探同步问题。
人员同步由中心服务按设备协议处理。支持主动下发的设备会排队执行，通用 HTTP 设备则通过拉取变更并回传结果完成同步；具体处理速度以现场网络和部署配置为准。UDP 20785 发现的是参与发现协议的系统节点，识别设备协议心跳是另一条链路，不应混用两者的在线状态。