更新记录

1.0.1(2026-11-20)

  • 精简文档:只保留功能与用法说明,去掉实现细节。

  • 支持中普达、新大陆、海信、优博讯、东大集成/信雅达、商米、BayNexus 七类厂商机型自动识别

  • 提供 getDeviceInfo / isSupported / onScan / offScan / start / stop / triggerScan / stopScanHead / setBeep

  • 支持传入自定义参数适配未知机型

  • 中普达机型额外支持提示音与震动开关

  • 已适配 Android 13+ 广播注册新规,保证能收到设备侧结果

  • 扫码结果字节流兼容 UTF-8 / GBK 双解码

1.0.0(2026-11-20)

  • 首版发布
  • 支持中普达、新大陆、海信、优博讯、东大集成/信雅达、商米、BayNexus 七类厂商机型自动识别
  • 提供 getDeviceInfo / isSupported / onScan / offScan / start / stop / triggerScan / stopScanHead / setBeep
  • 支持传入自定义参数适配未知机型
  • 中普达机型额外支持提示音与震动开关
  • 已适配 Android 13+ 广播注册新规,保证能收到设备侧结果
  • 扫码结果字节流兼容 UTF-8 / GBK 双解码

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × √ × × ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

uni-pda-scanner · PDA 硬件扫码枪

手持终端(PDA)自带激光/影像扫描头,按下侧键即可扫码。这类扫描头不走相机, 由设备系统直接输出结果。本插件把各厂商不同的接入方式统一成一套 API。

特性

  • 自动识别机型,内置 7 类厂商适配,无需手动配置
  • 持续回调:一次 onScan + start,之后每次按键都回调
  • 无需权限:不调相机、不联网、不需要任何 Android 权限
  • 软触发:支持的机型可代码触发扫描头(triggerScan)
  • 自定义机型:未知机型可传入自定义参数完成适配
  • 中普达机型额外支持提示音/震动开关

支持的厂商

厂商 支持
中普达 ✅
新大陆 ✅
海信医疗 ✅
优博讯 UROVO ✅
东大集成 iData / 信雅达 ✅
商米 SunMi ✅
BayNexus 及兼容组 ✅

普通手机调用 start 不会报错,但收不到结果——用 isSupported 先判断。

快速上手

import { isSupported, onScan, start, stop, triggerScan } from '@/uni_modules/uni-pda-scanner'

// 1. 判断设备
isSupported({
  success: (res) => {
    console.log(res.supported, res.vendor, res.model)
  }
})

// 2. 注册回调(一次即可,可执行多次)
onScan((res) => {
  console.log('扫码结果', res.result, res.source)
})

// 3. 开始监听
start({
  success: (res) => console.log('已监听', res.actions),
  fail: (err) => console.error(err.errCode, err.errMsg)
})

// 4. 代码触发一次扫描(部分机型支持)
triggerScan({})

// 5. 页面卸载时停止
stop({})

自定义机型:

start({
  actions: ['com.your.brand.SCAN_RESULT'],
  category: 'com.your.brand.category'
})

API

方法 说明
getDeviceInfo(options) 返回品牌、机型、厂商、推荐 action
isSupported(options) 是否识别为带扫描头的 PDA
onScan(callback) 注册持续扫码回调
offScan() 移除回调
start(options) 注册广播,开始监听
stop(options) 注销广播
triggerScan(options) 软触发一次扫描
stopScanHead(options) 关闭厂商扫描头服务
setBeep(options) 提示音 / 震动开关(部分机型)
getVersion() 插件版本

onScan 回调结构

{
  result: string      // 扫码内容
  action: string      // 来源广播 action
  key: string         // 命中的 extra key(排查用)
  source: string      // broadcast / vendor
  timestamp: number
}

错误码

错误码 说明
9130001 参数错误
9130002 当前设备不支持硬件扫码枪
9130003 尚未开始监听
9130004 广播注册失败
9130005 广播发送失败
9130006 已在监听中
9130007 该机型不支持扫码能力
9130008 内部错误

注意事项

  • 必须打自定义基座:插件含原生代码与依赖,标准基座不可用。
  • 扫描头按键后是否需要「先聚焦某个输入框」取决于厂商设置,与本插件无关。
  • 部分机型(如海信)扫描头服务常驻,离开页面建议调用 stopScanHead。
  • 鸿蒙平台暂不支持,调用返回 9130002。

平台支持

平台 支持
Android ✅
鸿蒙 ❌(API 形状一致,统一返回 9130002)
iOS ❌

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无需任何 Android 权限;不调用相机、不联网

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集、不上传任何扫码数据,扫码结果只在本地回调给业务代码

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。