app端新增原材料送检功能

JeecgUniapp-master/docs/DT50扫描识别-广播参数与接入说明.md

@@ -0,0 +1,136 @@
+# DT50 扫描识别 —— 广播参数与接入说明
+
+> 面向 APP「协作」页「扫描识别」功能。
+> 设备：优博讯 UROVO **DT50**（Android 11）。
+> 参数来源：**设备实测 adb logcat 抓真实扫码** + **优博讯官方 ScanManager 文档** + **DCloud UniApp 官方示例** 三方交叉验证。
+> 记录日期：2026-07-20。
+
+---
+
+## 一、核心参数（最重要）
+
+| 项目 | 值 | 说明 |
+|---|---|---|
+| 输出方式 | **Intent / 广播** | 设备当前**已是此模式**，无需在设置页切换 |
+| 广播 Action | `android.intent.ACTION_DECODE_DATA` | 实测 + 官方一致 |
+| 条码文本（String） | `barcode_string` | 官方常量 `BARCODE_STRING_TAG`，**首选** |
+| 原始字节（byte[]） | `barcode` | 官方常量 `DECODE_DATA_TAG`，兜底用 |
+| 长度（int） | `length` | 官方常量 `BARCODE_LENGTH_TAG` |
+| 码制（int/String） | `barcodeType` | 官方常量 `BARCODE_TYPE_TAG`，实测读出 `Code128` |
+| 扫描键 keycode | `523` | KEYCODE_SCAN（机身侧键） |
+
+## 二、设备侧验证结论
+
+- **硬件**：成像头正常，成功解出 Code128 条码 ✅
+- **触发**：侧键 keycode = 523，按下发 `ACTION_KEYCODE_SCAN_PRESSED`
+- **广播**：成功解码时实测发出 `android.intent.ACTION_DECODE_DATA (has extras)` 并被接收 ✅
+- **模式**：当前即广播输出（非键盘输出），**直接 registerReceiver 即可**
+- **无需**：原生 `.aar` 插件 / 自定义基座 / USB 驱动 / 完整 AndroidStudio 套壳；标准基座即可
+
+相关系统组件（备查）：
+- 扫描设置 App：`com.ubx.barcodescanner.tool`
+- 扫描服务：`com.ubx.uscanner`
+- DataWedge 式配置：`com.ubx.datawedge`
+
+## 三、UniApp 监听代码（标准基座，无需插件）
+
+```js
+let scanReceiver = null;
+
+/** 开始监听 DT50 扫描广播 */
+function startScanListener(onBarcode) {
+  const main = plus.android.runtimeMainActivity();
+  const IntentFilter = plus.android.importClass('android.content.IntentFilter');
+  const filter = new IntentFilter();
+  filter.addAction('android.intent.ACTION_DECODE_DATA'); // DT50 广播 Action
+
+  scanReceiver = plus.android.implements('io.dcloud.feature.internal.reflect.BroadcastReceiver', {
+    onReceive: function (context, intent) {
+      plus.android.importClass(intent);
+      // 首选直接取字符串
+      let code = intent.getStringExtra('barcode_string');
+      // 兜底：部分场景用字节数组
+      if (!code) {
+        const bytes = intent.getByteArrayExtra('barcode');
+        if (bytes) code = plus.android.newObject('java.lang.String', bytes);
+      }
+      const type = intent.getStringExtra('barcodeType'); // 码制，可选
+      if (code) onBarcode(code, type);
+    }
+  });
+  main.registerReceiver(scanReceiver, filter);
+}
+
+/** 停止监听（务必在页面卸载时调用，避免重复注册 / 内存泄漏） */
+function stopScanListener() {
+  if (scanReceiver) {
+    plus.android.runtimeMainActivity().unregisterReceiver(scanReceiver);
+    scanReceiver = null;
+  }
+}
+```
+
+页面接入：
+
+```js
+onLoad() {
+  startScanListener((code, type) => {
+    this.barcode = code;
+    // TODO: 调 MES 后端接口 / 查料
+  });
+},
+onUnload() {
+  stopScanListener();
+}
+```
+
+> 注意：仅 App（plus 环境）下可用，H5/小程序无 `plus`，接入时需做平台判断（`#ifdef APP-PLUS`）。
+
+## 四、故障排查
+
+| 现象 | 原因 / 处理 |
+|---|---|
+| 收不到广播 | 确认扫描设置里输出为「Intent/广播」而非「键盘/输入法」；确认 Action 拼写 |
+| 扫描后文本框被输入内容 | 键盘输出模式也开了，去扫描设置关掉键盘输出 |
+| `barcode_string` 为空 | 用兜底的 `barcode`(byte[]) 转 String |
+| 一直解码失败（红光有但不出码） | 距离 15~20cm，红光完整压住条码，拿稳 1~2 秒；避免手机屏幕反光码 |
+
+## 五、参考
+
+- 优博讯官方 ScanManager 文档：https://en.urovo.com/developer/android/device/ScanManager.html
+- DCloud UniApp 监听优博讯扫码广播（含示例）：https://ask.dcloud.net.cn/article/36468
+
+## 六、本仓库接入位置（2026-07-20）
+
+| 项 | 位置 |
+|---|---|
+| 菜单入口 | `src/common/work.ts` → 其他服务「合同」后「扫描识别」 |
+| 页面 | `src/pages/scanIdentify/scanIdentify.vue` |
+| 广播工具 | `src/utils/dt50Scan.ts` |
+| 行为 | 仅广播展示条码/码制/时间，不调后端、不弹输入法 |
+| 生命周期 | `onShow` 注册 / `onHide`+`onUnload` 注销；同码防抖 |
+
+## 七、键盘输出 vs 广播输出
+
+| | 键盘输出（Keyboard / 楔入） | 广播输出（Intent / Broadcast） |
+|---|---|---|
+| 原理 | 把条码当成「敲键盘」打进当前焦点输入框 | 系统发广播，App 用 `registerReceiver` 收 |
+| App 是否要抢焦点 | 要，通常还会弹出软键盘 | **不需要**输入框焦点 |
+| 适合场景 | 记事本、任意输入框快速验证 | 业务页稳定取码、拿码制等扩展字段 |
+| 本页策略 | 已关闭楔入，避免弹输入法 | **本页只走广播** |
+
+设备设置建议：扫描设置 → 关闭「键盘输出」，开启「Intent/广播输出」。
+本页进入时会主动 `hideKeyboard`，不自动聚焦任何输入框。
+
+## 附：参数是如何抓到的（可复现）
+
+```bash
+# adb 路径（本机 Android SDK）
+ADB="C:/Users/hp/AppData/Local/Android/Sdk/platform-tools/adb.exe"
+
+$ADB devices -l                    # 确认 DT50 已连（USB 调试）
+$ADB logcat -c                     # 清空日志缓冲
+$ADB shell "timeout 40 logcat -v threadtime '*:V'" > scan.log   # 抓 40s
+# 抓取期间用 DT50 侧键扫几次条码，然后：
+grep -E "ACTION_DECODE_DATA|barcodeType|DECODER" scan.log
+```