更新记录

1.2.0（2026-07-14）

• 新增 successTipText 配置项，用于自定义连续扫码成功提示文案
• 新增 pinchZoom 配置项，用于控制扫码页面是否支持双指缩放
• 修复连续扫码模式下，从相册识别成功后扫码页面会直接退出的问题

1.1.0（2026-07-13）

• 新增 deduplicate 配置项，用于控制连续扫码结果是否去重，默认 false
• 新增 scanInterval 配置项，用于限制连续扫码回调的最小间隔（ms）
• 新增 showSuccessTip 配置项，用于控制连续扫码成功提示是否显示
• 新增 closeScan() 方法，可主动关闭扫码页面
• 修复了一些问题

1.0.2（2026-07-11）

• 修复连续扫码多次触发回调时，可能出现 success/complete 回调函数已释放，不能再次执行 的问题

平台兼容性

uni-app(3.8.0)

uni-app x(3.8.0)

s-scan 原生扫码插件

s-scan 是一个 UTS 原生扫码插件，支持 App Android 和 App iOS。插件提供接近微信扫码的全屏体验，包含实时扫码、相册识别、手电筒、多码点选、连续扫码、震动和提示音等能力，可用于设备绑定、商品条码识别、票券核销、二维码登录等场景。

重点提示：本插件是 UTS 原生插件，本地运行和真机调试前需要先制作并使用自定义调试基座。直接使用标准基座运行时，原生扫码能力不会被打包进 App，可能出现插件不存在、调用失败或无响应等情况。

功能特性

• 支持二维码、常见条形码、DataMatrix、PDF417。
• 支持 scanCode(options) 回调写法和 scanCodeAsync(options) Promise 写法。
• 支持自定义标题、提示文案、提示背景色、扫描线颜色和手电筒激活色。
• 支持相机扫码和相册图片识别。
• 支持同时识别多个码时手动点选目标码。
• 支持连续扫码，适合批量盘点、批量核销等场景。
• 支持业务代码主动关闭当前扫码页。
• 支持扫码成功后的震动和 Beep 提示音。
• 支持 onlyFromCamera、success、fail、complete 等 uni.scanCode 常用字段。

安装说明

1. 在插件市场导入本插件到项目。
2. 确认项目已包含 uni_modules/s-scan 目录。
3. 在需要扫码的页面中按下面示例导入并调用。

import { scanCode, scanCodeAsync, closeScan } from '@/uni_modules/s-scan'

基础用法

回调写法

import { scanCode } from '@/uni_modules/s-scan'

scanCode({
  title: '扫码',
  content: '将二维码或条形码放入屏幕内',
  scanType: ['qrCode', 'barCode'],
  success(res) {
    console.log('扫码结果', res.result)
  },
  fail(err) {
    console.log('扫码失败', err.errCode, err.errMsg)
  },
  complete(res) {
    console.log('扫码完成', res)
  },
})

Promise 写法

import { scanCodeAsync } from '@/uni_modules/s-scan'

try {
  const res = await scanCodeAsync({
    title: '扫码',
    content: '将二维码或条形码放入屏幕内',
  })
  console.log('扫码结果', res.result)
} catch (err) {
  console.log('扫码失败', err.errCode, err.errMsg)
}

完整配置

scanCode({
  title: '设备扫码',
  titleStyle: {
    color: '#FFFFFF',
    fontSize: 18,
  },
  content: '请扫描设备机身二维码',
  contentStyle: {
    color: '#FFFFFF',
    fontSize: 15,
    backgroundColor: '#66000000',
  },
  scanType: ['qrCode', 'barCode'],
  vibrate: false,
  beep: false,
  manualSelect: true,
  scanLineColor: '#07C160',
  flashlightActiveColor: '#07C160',
  autoZoom: true,
  pinchZoom: true,
  showFlashlight: true,
  showAlbum: true,
  continuous: false,
  deduplicate: false,
  showSuccessTip: true,
  successTipText: '扫描成功',
  scanInterval: 1200,
  onlyFromCamera: false,
  success(res) {},
  fail(err) {},
  complete(res) {},
})

连续扫码

开启 continuous 后，扫码页不会在识别成功后自动关闭。每次识别到结果都会触发 success；用户关闭扫码页时，会再返回一次当前已识别结果列表。

scanCode({
  continuous: true,
  success(res) {
    if (Array.isArray(res.result)) {
      console.log('本次连续扫码汇总', res.result)
      return
    }
    console.log('单次扫码结果', res.result)
  },
})

使用 scanCodeAsync 开启连续扫码时，Promise 会在用户关闭扫码页并返回汇总结果后 resolve。

如需在连续扫码中让相同内容只回调并汇总一次，可设置 deduplicate: true。默认 false，相同码再次识别时仍会触发回调，并保留在关闭页面时返回的汇总列表中。

连续扫码成功后默认会显示轻量的“扫描成功”提示，可通过 showSuccessTip: false 关闭，也可以通过 successTipText 自定义提示文案；scanInterval 用于设置两次自动连续扫码回调之间的最小间隔，单位毫秒，默认 1200。用户手动点选多码结果时不受该间隔限制。

连续扫码时从相册选取图片识别成功后，会触发一次 success 回调并继续停留在扫码页；用户关闭扫码页时才会返回已识别内容数组。

主动关闭扫码页

import { closeScan } from '@/uni_modules/s-scan'

const closed = closeScan()
console.log('是否已发起关闭', closed)

closeScan() 会关闭当前正在运行的扫码页，并返回 boolean 表示是否存在可关闭的扫码页。普通扫码会触发取消失败回调，错误码为 1300004；连续扫码会和用户点关闭按钮一样，返回当前已识别结果数组。

参数说明

返回值

type ScanCodeSuccess = {
  result: string | string[]
  scanType: string
  rawScanType?: string
  fromAlbum?: boolean
  charSet?: string
}

错误码

权限配置

Android 插件已声明以下权限：

• android.permission.CAMERA
• android.permission.VIBRATE
• android.permission.READ_EXTERNAL_STORAGE
• android.permission.READ_MEDIA_IMAGES

iOS 需要在 manifest.json 中配置相机和相册用途说明：

{
  "NSCameraUsageDescription": "需要使用相机扫描二维码或条形码",
  "NSPhotoLibraryUsageDescription": "需要访问相册以识别图片中的二维码或条形码"
}

示例工程已内置以上配置，接入业务项目时请按项目实际文案调整。

注意事项

• 本插件仅支持 App Android 和 App iOS，H5 和小程序端不会启用原生扫码能力。
• 当 content 为空字符串时，扫码页不会显示提示文字，也不会显示提示背景。
• onlyFromCamera 为 true 时会隐藏相册入口；如果同时设置了 showAlbum: true，仍以 onlyFromCamera 为准。
• pinchZoom 开启后，用户双指缩放会优先使用手动倍率，本次扫码中 autoZoom 不会继续覆盖用户设置。
• 多码选择的箭头位置来自原生识别框坐标。识别到多个候选码时，插件会短暂聚合候选、冻结摄像头画面，并将左上角按钮变为“取消”，由用户点选目标码。
• 连续扫码模式下，插件不会自动关闭扫码页；相册识别成功后会继续停留在扫码页，用户点左上角关闭时会返回已识别内容数组。
• Android 相册识别依赖系统图库返回图片 URI；部分定制 ROM 的图库如果不返回标准图片 URI，可能无法识别。