更新记录

1.0.0（2026-04-23） 下载此版本

新增

• 基于 Google ML Kit Barcode Scanning 的 Android UTS 扫码组件（easy-scanner）。
• 支持多种条码格式（可配置 formats，默认 ALL）。
• 可配置扫码框：位置、尺寸、边框与四角样式；半透明遮罩；多码模式下标记颜色。
• 闪光灯、扫码开关、多码识别、双指缩放、扫码框显隐等能力。
• 对外事件：init、error、scanned、multi-scanned；方法：toggleFlashlight、setZoomRatio、pauseScan、resumeScan、rescan。

修复

• scanInFrameOnly：此前框内限制易失效。已按相机帧 rotationDegrees 与 ML Kit 有效坐标系对齐，使用 Matrix（ScaleToFit.CENTER）将扫码框从预览视图映射到分析图像坐标，与 PreviewView 居中适配一致；interest 无法计算时不再误放行整帧结果；boundingBox 为空时不再视为命中框内。

平台说明

• 当前仅支持 Android（utssdk/app-android）。

平台兼容性

uni-app(4.87)

uni-app x(4.83)

easy-scanner

基于 Google MLKit Barcode Scanning 的高性能 UTS 扫码组件，仅支持 Android 平台。

功能特性

• 支持 13 种编码格式：QR_CODE、AZTEC、CODABAR、CODE_39、CODE_93、CODE_128、DATA_MATRIX、EAN_8、EAN_13、ITF、PDF417、UPC_A、UPC_E
• 可配置识别的编码格式
• 自定义扫码框样式（位置、尺寸、颜色、四角样式）
• 半透明遮罩层
• 闪光灯开关控制
• 双指缩放调整相机焦距
• 多码识别模式（多个编码同时出现时标记并供用户选择）
• 扫码启用/暂停控制
• 支持自定义内容覆盖到相机区域（slot 插槽）

使用方式

<easy-scanner
  ref="scanner"
  :formats="'QR_CODE,EAN_13'"
  :flashlight="false"
  :scanEnabled="true"
  :multiScan="false"
  :showScanBox="true"
  :scanInFrameOnly="true"
  :enableZoom="true"
  :scanBoxWidth="220"
  :scanBoxHeight="220"
  :scanBoxBorderColor="'#00FF00'"
  :scanBoxCornerLength="40"
  :scanBoxCornerWidth="6"
  :overlayColor="'#80000000'"
  :markerColor="'#FF4444'"
  @init="onInit"
  @error="onError"
  @scanned="onScanned"
  @multi-scanned="onMultiScanned"
  style="width: 750rpx; height: 500px;">
  <text>自定义覆盖内容</text>
</easy-scanner>

Props 属性

Events 事件

Methods 方法

通过 this.$refs.scanner 调用：

scanType 与 uni.scanCode 的对应关系