更新记录

1.0.0（2026-08-18）

扫码插件，支持二维码、条码，连续扫码、相册图片识别、手动聚焦缩放功能、相机自动缩放，组件插件

1.0.0

• init nv-scan

平台兼容性

uni-app(5.15)

uni-app x(5.15)

nv-scan

nv-scan 是一个 uni-app UTS 扫码插件，提供全屏扫码 API 和 nv-scan-view 组件入口。当前版本先提供可编译、可运行的 UTS 插件 API；如需 ML Kit/CameraX 真原生连续扫码内核，需要制作自定义基座后接入 Android 原生依赖。

平台

• App-Android
• App-iOS

H5、小程序端不支持。

API

import {
  openCamera,
  closeCamera,
  setContinuousScanStatus,
  warmupCameraProvider,
  scanImageByPath
} from '@/uni_modules/nv-scan'

openCamera

openCamera(
  {
    continuous: false,
    continuousDelay: 800,
    formatsVal: '0',
    scanBox: true,
    styleFollowIos: false,
    scanBoxHeight: 520,
    showToast: true,
    showToastText: '识别成功'
  },
  (res) => {
    console.log(res.scanCode, res.scanCodeType)
  },
  (err) => {
    console.log(err.code, err.message)
  }
)

closeCamera

closeCamera()

setContinuousScanStatus

setContinuousScanStatus(false)
setContinuousScanStatus(true)

scanImageByPath

scanImageByPath(
  { path: localPath, formatsVal: '0' },
  (res) => {},
  (err) => {}
)

formatsVal

• 0：全部格式
• 1：CODE_128
• 2：CODE_39
• 4：CODE_93
• 8：CODABAR
• 16：DATA_MATRIX
• 32：EAN_13
• 64：EAN_8
• 128：ITF
• 256：QR_CODE
• 512：UPC_A
• 1024：UPC_E
• 2048：PDF417
• 4096：AZTEC

多个格式可按位相加，例如二维码和 EAN_13 可传 288。

组件

<nv-scan-view
  style="width: 100%; height: 420rpx;"
  :continuous="true"
  :auto-start="true"
  formats-val="0"
  @success="onScanSuccess"
  @error="onScanError"
/>

组件方法：start()、stop()、pause()、resume()、setTorch(enabled)。