更新记录

1.0.0（2026-06-17） 下载此版本

• 首次发布
• Android APP 空闲捕获 USB HID 扫码枪
• 视图层 evalJS 注入 + plus.storage 桥接逻辑层
• 提供 Vue2 插件安装与全局 mixin

平台兼容性

uni-app(5.0)

lt-scan-gun

Android APP 端 USB / 蓝牙 HID 键盘模式扫码枪插件。采用「空闲捕获」：仅在无业务输入框聚焦时，让隐藏 input 接收扫码，不干扰用户填表。

平台支持

快速接入

1. 安装插件

将 uni_modules/lt-scan-gun 复制到项目 uni_modules 目录。

2. main.js 注册

import ltScanGun from '@/uni_modules/lt-scan-gun/js_sdk/install.js'

Vue.use(ltScanGun, {
  enableLog: true,      // 是否 console.log('[scanGun]', code)
  minLength: 3,         // 最短条码长度
  pollInterval: 80      // storage 轮询间隔 ms
})

注册后每个页面 onShow 会自动注入视图层捕获脚本，无需手动加组件。

3. App.vue 启动（可选）

import { startGlobalScanGun } from '@/uni_modules/lt-scan-gun/js_sdk/index.js'

onLaunch() {
  startGlobalScanGun()
  console.log('[scanGun] App 启动，等待扫码...')
}

4. 业务页订阅扫码

import { onGlobalScanGun } from '@/uni_modules/lt-scan-gun/js_sdk/index.js'

export default {
  data() {
    return { offScan: null }
  },
  onShow() {
    this.offScan = onGlobalScanGun((code) => {
      console.log('收到条码', code)
    })
  },
  onHide() {
    this.offScan && this.offScan()
    this.offScan = null 
  }
}

或使用实例 API：

this.$scanGun.on((code) => { /* ... */ })

API

事件名：scan-gun:commit（SCAN_EVENT）

原理简述

1. 视图层：evalJS 注入隐藏 input，空闲时 focus，Enter 时写入 plus.storage
2. 逻辑层：轮询 storage → console.log + uni.$emit
3. 业务输入框有焦点时：不抢焦点，条码进入当前输入框

注意事项

• 仅适用于 HID 键盘模式扫码枪，PDA Intent 广播请用其他方案
• 全屏 web-view 内 H5 页面需单独处理（插件注入在外层 uni 页 WebView）