文豆条码采集可自动扫码拍照实现全流程自动化
文豆条码自动采集功能基于文豆高拍仪扫码SDK实现一维码二维码全流程自动化识别与拍照。摄像头实时扫描画面,识别到条码后自动语音播报条码数量并拍照存档,支持自动上传服务器。系统内置双重防重机制,同一码在规定时间内只采集一次,避免重复拍照。针对多码场景,采用智能状态:多码同现只拍一张、新增码自动补拍、全部移走后可重新采集。页面提供「重置已拍码」按钮,拍糊后可原地重拍同一批码。该功能显著提升条码采集效率,适用于生产追溯、仓储物流、质检登记、档案留存等场景。
业务流程:设备扫码 → 扫码结果回调 → 码去重 → 批次判断 → 自动拍照→ [可选]上传后端
业务逻辑:
1. 扫码识别
• 设备通过扫码模组实时扫描,扫到码后经 WebSocket 回调返回结果。
• 回调:ScanCodeResult,字段 result 为码值。
• 码制:默认「多码制扫描」,同时支持二维码和条码。
2. 码去重(防同一码短时间重复触发)
双重保障:
• 服务端去重:Dec_SetSameCodeCheckType(1) + Dec_SetSameCodeTime(2000),同一码2000ms内只输出一次。
• 前端兜底:IsDuplicateCode(codeStr) 再按2000ms窗口过滤一次。
3. 自动拍照触发规则(多码只拍一张 / 加码再拍 / 清空后再拍)
• 维护活跃码集合 activeCodes(码→最后出现时间戳),记录当前画面里仍在的码。
• 新码判定:收到的码不在 activeCodes 里即为「新码」;每次收到码会刷新其出现时间。
• 拍照触发:仅「新码」且距上次拍照超过 BATCH_GAP_MS(2000ms)视为新一批时拍照;同一次放入的多个码(间隔 < 2000ms)合并,只拍第一张。识别到新码后延迟 1 秒(CAPTURE_DELAY_MS=1000ms)再拍照,让画面稳定、避免拍糊。
• 再次触发:码未移走又加入新码(间隔 > 2000ms)再拍一张;码全部移走后,画面清空检测(startClearWatcher清理超过 CLEAR_GAP_MS=3000ms 未出现的码)复位状态,重新放入也再拍一张。
• 拍照失败时复位状态允许重试;页面提供「重置已拍码」按钮:手动清空已识别码集合(activeCodes)、上次拍照时间(lastCaptureMs)与上次拍照码值(lastShotCode)。点击时立即触发一次重拍(仅保留 1 秒画面稳定延时,不再等待服务端约 2 秒的重码去重周期,不再语音提示):优先重拍画面里最近的码,若画面码集合已被“清空检测”清掉(码持续在画面、设备不再反复回调),则沿用上次拍照码值(lastShotCode)重拍;该按钮点一次只生效一次,每次想原地重拍同一批码都需重新点击。适用于拍糊后原地重拍或立即重新开始采集。
4. 自动拍照与命名
• 触发:调用 Dec_Capture(保存路径)。
• 命名规则:YYYYMMDDHHMMSS + 3位毫秒 + .jpg(共 17 位时间戳,防同秒重名)。
• 保存目录:页面「保存目录」输入框配置。
5. 拍照结果
•回调 Dec_Capture 返回:
•success:0 = 成功,非 0 = 失败;
•base64:图片数据(纯 base64,不含前缀);
•filePath:本地落盘路径。
