更新记录

1.0.4（2026-08-17）

• 修复 Android 选图成功后，*** / 自定义识别结果的矫正车牌图滞后一张：
• Demo 首页新增插件版本号，
• 插件 1.0.3 → 1.0.4，SDK 0.3.38 → 0.3.39。

1.0.3（2026-08-17）

• 修复 iOS 云端打包编译失败（Unable to find module dependency: 'lpr'）：
• 插件 1.0.2 → 1.0.3

1.0.2（2026-08-17）

• 修复 Android 首次启动调用“选图 / ***”报 9010004： 首次使用尚未捕获宿主 Activity 时，改为应用上下文 + NEW_TASK 兜底启动；
• 修复 Android Demo 相机拍摄提示“打包时未添加 camera 模块”： Demo manifest 补充 Camera 模块；
• 修复 Android 首页车牌截图不显示：矫正车牌图路径统一返回 file:// 前缀， Demo 展示前再做一次路径归一化；
• Demo 首页底部展示插件版本号（新增 getSdkVersion() 接口可查询底层 SDK 版本，Demo 未展示）；
• Android ***配置面板移除“弹出方式”（扫描页固定为新页面打开， iOS 保留该配置）；
• Demo 文案中的“SDK”统一改为“插件”，便于理解；
• SDK 版本 0.3.36 → 0.3.37，插件版本 1.0.1 → 1.0.2。

平台兼容性

uni-app(3.8.2)

其他

LPR 车牌识别（ad-lpr-ocr）

本地离线车牌识别 UTS 插件：摄像头实时识别、选图识别、车牌类型判定（中文）。

• 纯本地推理：识别过程完全在设备上完成，不采集、不上传任何数据；
• 全流程内置：相册选图、摄像头扫描、车牌矫正图、都由插件本身完成，业务方只需接收结果。

安装

在 uni-app 项目的 uni_modules 目录导入本插件（HBuilderX 插件市场安装或 手动拷贝 ad-lpr-ocr 目录）。

快速开始

uni-app Demo 已提供三个入口：插件自带选图、插件自带摄像头实时识别、自定义获取图片传给插件识别 （页面内含拍摄/相册两种取图方式）。运行 platforms/uni_plugin/demo 即可体验。

import {
  recognizeImage,
  recognizeImagePath,
  startScan,
  setLicense,
  getVersion,
  getSdkVersion
} from '@/uni_modules/ad-lpr-ocr'

// 选图识别：拉起系统相册 → 自动识别 → 回调
recognizeImage({
  debug: false,
  success: (res) => {
    console.log(res.plateText, res.plateType, res.confidence)
  },
  fail: (err) => {
    console.error(err.errCode, err.errMsg)
  }
})

// 自定义图片识别：不弹系统相册，直接识别本地图片文件
recognizeImagePath({
  path: '/storage/emulated/0/plate.jpg',
  success: (res) => {
    console.log(res.plateText, res.plateType)
  }
})

// 摄像头实时识别：弹出 SDK 扫描页 → 识别成功自动关闭并回调
startScan({
  presentMode: 'sheet',        // 'sheet' 底部弹出 / 'push' 导航栈 push （仅支持iOS）
  showFrame: true,             // 是否显示识别框
  frameColor: '#00FF00',       // 识别框颜色
  hintText: '请将车牌对准框内', // 提示文字（自动换行）
  maxZoom: 10,                 // 最大放大倍率
  showZoomLabel: true,         // 是否显示当前倍率
  closeButtonText: '关闭',      // 底部弹出模式的关闭按钮文字
  success: (res) => {
    console.log(res.plateText, res.plateType)
  }
})

// 版本号
console.log(getVersion())

API

recognizeImage(options)

拉起系统相册选择图片并识别。

参数：

recognizeImagePath(options)

自定义选图/拍照识别：不拉起系统相册，直接识别本地图片文件。

参数：

示例（自己选图后拿到路径再识别）：

uni.chooseImage({
  count: 1,
  success: (res) => {
    recognizeImagePath({
      path: res.tempFilePaths[0],
      success: (r) => console.log(r.plateText, r.plateType)
    })
  }
})

startScan(options)

弹出插件摄像头实时识别页面，识别成功后自动关闭并回调。

在 recognizeImage 参数基础上增加：

getVersion()

返回插件版本号字符串。

识别结果

{
  plateText: '沪A12345',        // 车牌文本
  plateType: '小型汽车',        // 车牌类型中文名
  confidence: 0.99,             // 置信度 0~1
  totalMs: 386,                 // 识别总耗时（毫秒）
  plateImagePath: '/tmp/...',   // 矫正后的车牌图（400x120），可为空；
                               // iOS 为绝对路径，Android 为 file:// 前缀路径
  debugLog: ''                  // debug=true 时的完整调试日志
}

错误码

平台支持

• app-ios：支持
• app-android：支持

隐私

插件不采集任何数据：识别在本地离线完成，不包含广告 SDK、统计 SDK， 仅申请相机权限（摄像头实时识别）与相册访问（选图）。