更新记录
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 | ❌ |

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 1
赞赏 0
下载 12778098
赞赏 1960
赞赏
京公网安备:11010802035340号