更新记录

1.1.0（2026-08-26）

• 新增 UROVO i8310T PDA Broadcast 真机验证。
• 新增 UROVO USB HID、2.4G HID、Bluetooth HID：真机验证。
• 新增硬件测试中心，支持真实扫码测试与顺序压力测试。
• 优化 UROVO Profile、Broadcast Action/DataKey 兼容与真机诊断日志。
• 真实扫码测试不再限制条码或二维码内容，可测试商品条码、普通二维码、支付二维码、网址、中文、数字、英文和长文本。
• 优化重复扫码统计，同一内容连续扫码不再被误判为硬件异常。
• 优化 Demo 首页，统一展示设备、厂商、Profile、监听状态、最后扫码结果和扫码次数。
• 优化 PDA 小屏页面布局、按钮和中文短文案换行问题。
• 优化扫码监听生命周期和页面切换时的监听释放。

1.0.0（2026-08-08）

SL-ScanBridge 是面向 Android uni-app / uni-app x 场景的扫码枪统一接入插件。插件把 PDA Broadcast、USB HID、蓝牙 HID、2.4G 接收器和模拟键盘扫码输入统一为一套 API，业务页面通过 onScan() 获取扫码结果，不需要维护隐藏 input、焦点抢占或多个厂商广播适配逻辑。

插件适合 WMS、仓储、ERP、MES、进销存、物流、快递、PDA 拣货、库存盘点、入库、出库、订单复核、门店盘点、固定资产管理、生产管理等需要高频扫码的企业场景。

当前 V1.0 已完成 UTS 源码、uni-app Demo 页面、Android 原生测试 Demo、API 文档、测试报告、设备兼容性报告、HBuilderX CLI 编译验证、Android 真机 Demo 安装启动验证、ADB 模拟 Broadcast 端到端验证。Harmony 设备已完成 Demo UI 前端编译和未签名 HAP 生成验证。真实 USB HID、蓝牙 HID、2.4G HID 和各厂商 PDA 真实扫码仍需目标设备继续验证。 建议购买前先使用 DCloud 插件试用功能，在目标 PDA / 扫码枪设备上完成兼容性验证。不同厂商及不同固件版本的广播参数可能存在差异，插件支持自定义 Broadcast Action / DataKey。

平台兼容性

uni-app(5.11)

uni-app x(5.11)

SL-ScanBridge

SL-ScanBridge 是面向 Android uni-app / uni-app x 的扫码枪统一接入 UTS 插件。插件把 PDA Broadcast、USB HID、Bluetooth HID、2.4G HID 接收器和模拟键盘扫码输入统一为一套 onScan() 回调，业务页面无需维护隐藏 input、焦点抢占或多套厂商广播适配逻辑。

已通过真实设备验证的是 UROVO i8310T 的 PDA Broadcast 链路。USB HID、2.4G HID、Bluetooth HID 及其它 PDA Profile 已有代码能力或预设，但仍需在目标硬件上完成真机验收。

功能特性

• 支持 auto / hid / broadcast 三种工作模式。
• 支持 PDA Broadcast 的 Action、DataKey、ExtraKeys 自定义。
• 支持 USB HID、Bluetooth HID、2.4G HID 等键盘输入类扫码设备接入。
• 支持 Zebra、Honeywell、UROVO、Newland、Seuic、iData 等常见厂商 Profile 预设。
• 支持 minLength、maxLength、prefix、suffix、trim、duplicateInterval 等过滤与去重配置。
• 提供统一 ScanResult，包含 code、source、manufacturer、deviceModel、barcodeType、timestamp。
• V1.1.0 新增硬件测试中心，支持真实扫码测试和顺序压力测试。

已验证设备

本次 UROVO i8310T 验证结果：manufacturer=UROVO、model=i8310T、profile=urovo、source=broadcast，真实扫码结果可通过 onScan() 正常返回。

尚待真实设备验证

“尚待真机验证”不等于不支持，只表示当前版本没有对应硬件的实测验收数据。

快速开始

import { startScan, stopScan, onScan, offScan } from '@/uni_modules/sl-scan-bridge'

function handleScan(res) {
  console.log(res.code, res.source)
}

onScan(handleScan)

await startScan({
  mode: 'auto'
})

// 页面退出时释放
offScan(handleScan)
await stopScan()

PDA Broadcast

UROVO i8310T 默认优先监听：

await startScan({
  mode: 'broadcast',
  manufacturer: 'urovo',
  broadcast: {
    action: 'android.intent.ACTION_DECODE_DATA',
    dataKey: 'barcode_string',
    extraKeys: [
      'barcode',
      'com.ubx.datawedge.data_string',
      'com.ubx.datawedge.barcodes',
      'scanData',
      'data',
      'scannerdata'
    ],
    charset: 'UTF-8'
  }
})

不同 PDA 的系统扫码输出可能需要在设备设置中调整为 Intent / Broadcast 输出，并确认实际 Action 和 DataKey。

HID 模式

USB HID、Bluetooth HID、2.4G HID 通常以键盘输入方式工作，可使用：

await startScan({
  mode: 'hid',
  keyInterval: 50,
  inputTimeout: 100,
  duplicateInterval: 500
})

真实硬件建议在目标设备上验证焦点、输入结束键、连续扫码间隔和业务页面生命周期。

硬件测试中心

V1.1.0 新增 Demo 硬件测试中心：

• 真实扫码测试：不限制扫码内容格式，商品条码、普通二维码、支付二维码、网址、中文、数字、英文和长文本只要返回非空内容即计为有效条码。
• 顺序压力测试：仅在用户主动选择“顺序压测”时启用 SL000001、SL000002、SL000003 这类编号解析、缺失、重复、乱序判断。
• 重复条码统计：仅表示连续扫码内容相同，不表示插件异常。真实扫码模式下，同一二维码连续扫描 5 次，扫码总数应增加 5 次。

权限说明

插件仅声明：

android.permission.VIBRATE

该权限只用于 enableVibration=true 时的扫码成功可选振动反馈。插件不申请相机、定位、蓝牙扫描、通讯录、短信、电话、存储等权限。

数据与隐私

插件不采集、不上传、不存储扫码数据。扫码结果仅在调用方应用本地通过 onScan() 回调返回，由业务项目自行处理。

平台说明

• 支持：Android uni-app、Android uni-app x。
• 不支持：iOS、HarmonyOS 扫码监听、H5、小程序。
• 涉及 Android 原生能力时，请使用符合项目配置的自定义基座或正式包进行真机验证；标准基座可能无法完整加载当前 UTS 原生能力。

当前限制

V1.1.0 不包含 RFID、NFC、摄像头扫码、OCR、云服务、账号系统、后台管理、iOS、HarmonyOS、小程序能力。厂商 Profile 是常见预设，不代表所有型号均已真机验证。