更新记录

1.0.0（2026-06-21）

• 发布插件
• 支持二维码和条形码扫描（13种格式）
• 支持OCR文本识别，自动提取手机号和身份证号
• 支持闪光灯控制
• 支持相机缩放（放大/缩小）
• 支持自定义扫描线、提示文案、边框颜色等UI元素
• 支持扫描完成提示音与震动反馈控制
• 支持Android 5.0及以上版本

平台兼容性

uni-app x(4.0)

安卓原生扫码OCR识别UTS插件 (scan-pro)

基于 uni.scanCode 调起系统摄像头扫码，内置智能文本解析引擎，自动提取手机号和身份证号。搭配可自定义扫描UI组件，适用于 uni-app x 项目，标准基座直接可用。

平台兼容性

uni-app x (5.07+)

需在 uni-app x 项目中使用 .uvue 文件。

功能特性

• 二维码和条形码扫描（QR码、EAN、Code128、Data Matrix、PDF417 等）
• 智能文本解析：自动提取手机号（1开头的11位数字）和身份证号（18位）
• 调用系统摄像头扫码，标准基座直接可用，无需自定义基座
• 自定义扫描框比例、扫描线颜色、边框样式、遮罩透明度、提示文案
• 扫描线 CSS 动画、闪光灯开关、提示音/自动停止控制
• 相机权限检查

快速开始

1. 放置扫描组件

<template>
  <view class="page">
    <scan-pro
      id="scannerPreview"
      :width="scannerWidth"
      :height="scannerHeight"
      :scanLineColor="'#00FF00'"
      :hintText="'请将条码置于框内扫描'"
      :showScanLine="true"
      :showOverlay="true"
    ></scan-pro>

    <view @tap="doScan"><text>开始扫码</text></view>
  </view>
</template>

2. 写脚本调用扫码

import { processScanResult, HasCameraPermission } from "@/uni_modules/scan-pro";

function doScan() {
  uni.scanCode({
    scanType: ["barCode", "qrCode", "datamatrix", "pdf417"],
    success: (res) => {
      const json = processScanResult(res.result, res.scanType)
      const rawValue = json.get("rawValue") as string
      const format   = json.get("format") as string
      const phones   = json.get("phoneNumbers") as string[]
      const idCards  = json.get("idCardNumbers") as string[]
      console.log(rawValue, format, phones, idCards)
    }
  })
}

API 参考

processScanResult(result, scanType)

解析 uni.scanCode 回调结果，自动提取手机号和身份证号。

参数

返回 UTSJSONObject，包含以下字段：

HasCameraPermission()

检查相机权限是否已授予，返回 boolean。

CreateNativeScannerContext(id)

创建扫描上下文，返回 INativeScannerContext 实例。

组件属性

支持的条码格式

智能文本解析

processScanResult 自动从扫码结果中匹配：

• 手机号：1 开头的 11 位连续数字
• 身份证号：18 位，末位可为 X

// 扫码"张三 *** 110101199001011234"的结果
{
  rawValue: "张三 *** 110101199001011234",
  format: "TEXT",
  valueType: 0,
  phoneNumbers: ["***"],
  idCardNumbers: ["110101199001011234"]
}

常见问题

扫描没有反应？

• 确认 Android 5.0 以上设备
• 首次使用需在系统设置中授予相机权限
• 调用 uni.scanCode() 触发扫码，非自动启动
• scanType 包含 "barCode" 确保条形码识别

文字重叠或被截断？

• 结果卡片设置了 max-height 和 lines 限制
• 可通过组件属性自定义样式

如何自定义UI？

• 设置 showOverlay="false" 隐藏内置覆盖层
• 参考 pages/custom/custom.uvue 完整自绘示例

演示项目

插件含 4 个演示页面：

插件信息

• 插件 ID：scan-pro
• 版本：1.0.0
• 平台：uni-app x Android 5.0+
• 依赖：无三方 SDK，标准基座直接可用