137 lines
5.6 KiB
Markdown
137 lines
5.6 KiB
Markdown
# 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
|
||
```
|