更新记录

1.0.0（2025-12-09） 下载此版本

• 初始版本：pda Android 广播扫码。

平台兼容性

uni-app(3.7.0)

其他

pda-scan

面向 Android PDA 广播扫码 的 uni-app 插件，封装扫码广播监听、防抖，支持自定义广播动作/结果 key/触发动作以适配不同厂商固件。提供示例组件便于直接运行调试。

平台支持

• App-Android (uni-app)
• 不支持：iOS / Web / 小程序 / 快应用

安装

• HBuilderX 导入 uni_modules/pda-scan
• CLI：复制 uni_modules/pda-scan 到项目并在页面引用组件/JS

快速开始

在页面引入组件

<template>
  <view>
    <pda-scan
      :scanAction="'android.intent.ACTION_DECODE_DATA'"
      :resultKey="'barcode_string'"
      :debounce="1000"
      :maxResults="10"
      :autoStart="true"
    />
  </view>
</template>

<script>
import PdaScan from '@/uni_modules/pda-scan/components/pda-scan/pda-scan.vue'
export default { components: { PdaScan } }
</script>

仅使用 JS 管理器

import scannerManager from '@/uni_modules/pda-scan/components/pda-scan/scanner.js'

scannerManager.setConfig({
  scanAction: 'android.intent.ACTION_DECODE_DATA', //广播动作
  resultKey: 'barcode_string'//广播标签
})
scannerManager.setScanDebounceTime(1000)
scannerManager.setMaxResults(10)

scannerManager.onSuccess((code, list) => console.log(code, list))
scannerManager.onError((err) => console.error(err))

scannerManager.init()
scannerManager.start()

API 摘要

• setConfig({ scanAction, resultKey })：配置广播动作、标签。
• init()：初始化广播接收器，返回 true/false。
• start() / stop()：开始/停止监听。
• pause() / resume()：仅暂停回调，不注销广播。
• onSuccess(code) / onError(code)。
• setScanDebounceTime(ms)：防抖时间。
• setMaxResults(n) / getResults()：结果缓存。
• destroy()：释放、清理回调。

广播适配说明

• 默认：结果广播 android.intent.ACTION_DECODE_DATA，结果 key barcode_string。
• 若设备厂商定义不同动作/extra key，按需修改 scanAction，resultKey。

注意事项

• 仅在 App 端（Android）生效，调用前需确保运行于 plus 环境。
• 建议在页面 onUnload 或组件销毁时调用 destroy 释放资源。
• 防抖与重复扫描判断默认 1000ms，可按业务调小。

变更日志

详见 changelog.md。