更新记录

0.1.1(2026-11-10)

  • 首版提供 Android 单次与连续扫码,支持同码重复间隔。
  • 支持二维码、常见一维码、闪光灯和相册图片识码。
  • 提供 uni-app Vue 3 与 uni-app x 示例工程。

平台兼容性

uni-app(5.24)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- √ × × √ × 7.0 × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

uni-app x(5.24)

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

其他

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

Android 连续扫码与单次扫码

适用于 Android 7.0 及以上的 uni-app Vue 3 / uni-app x 项目。提供单次、连续扫码,同一码重复间隔,二维码/条形码筛选、闪光灯与相册识码。仅支持 Android;安装后需制作包含本插件的自定义基座或云打包运行。两个示例工程已编译通过,真机和云打包尚未验证;uni-app Vue 2 未验证。

import { openScanbench } from '@/uni_modules/scanbench-scanner'

openScanbench({
  isContinuous: true,
  scanTimeSpace: 2000,
  onResult: ({ result, format }) => {
    console.log(result, format)
  },
  onClose: () => console.log('扫码界面已关闭'),
  onError: (message) => console.error(message)
})

需要从宿主主动关闭当前扫码界面时,另外调用 closeScanbench()。

scanTimeSpace 支持 500、1000、2000、3000、5000 毫秒;其他值会使用 2000 毫秒。连续模式仅对同一码去重,不同码可连续返回。扫码结果仅回调到当前应用,不上传到开发者服务器。相册识码使用系统文件选择器,不申请存储权限。

当前不支持同帧多码回调、任意自定义扫码界面或前置摄像头切换。识别效果与设备及现场光照有关,不承诺固定毫秒级速度。依赖 JourneyApps ZXing Android Embedded 4.3.0 与 ZXing Core,采用 Apache License 2.0;许可全文见 utssdk/app-android/libs/LICENSE-APACHE-2.0.txt。

隐私、权限声明

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

CAMERA(相机):实时扫码时调用摄像头;VIBRATE(振动):识别成功时提供振动反馈。相册识码使用系统文件选择器,不申请存储权限。

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

插件读取摄像头画面或用户选择的图片以识别码内容,结果仅回调给当前应用处理;插件本身不向开发者服务器发送扫码内容、图片或设备信息,也不设置服务器地址。宿主应用如何使用扫码结果由宿主开发者决定。

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

无

暂无用户评论。