更新记录

1.0.0（2026-09-10）

• 初始版本
• 支持 Android 平台
• 支持毫秒级车牌识别
• 支持图片识别（相册/拍照）
• 支持实时扫描识别（相机预览）
• 支持多种车牌类型（蓝牌、绿牌、黄牌等）
• 支持识别置信度配置
• 支持扫描超时设置

平台兼容性

uni-app(4.27)

uni-app x(4.72)

安卓车牌识别 UTS 插件

基于 HyperLPR3 引擎的毫秒级车牌识别插件，支持 Android 平台。

功能特性

• 毫秒级响应，识别速度快
• 支持多种车牌类型（蓝牌、绿牌、黄牌等）
• 支持图片识别（从相册或拍照）
• 支持实时扫描识别（相机预览）
• 识别置信度高，准确率高
• 离线识别，无需网络

安装

1. 将此插件复制到项目的 uni_modules 目录下
2. 确保已将 HyperLPR3 SDK 的 aar 文件放置在 utssdk/app-android/libs/ 目录下
3. 在HBuilderX中重新编译项目

使用方法

1. 初始化SDK

import { initHyperLPR } from "@/uni_modules/zy-hyperlpr";

initHyperLPR({
  detLevel: 1,           // 检测级别（1-3）
  maxNum: 1,             // 最大识别数量
  recConfidenceThreshold: 0.85,  // 识别置信度阈值
  success: (res) => {
    console.log('初始化成功:', res);
  },
  fail: (err) => {
    console.error('初始化失败:', err);
  }
});

2. 图片识别

import { recognizeImage } from "@/uni_modules/zy-hyperlpr";

recognizeImage({
  image: '/path/to/image.jpg',  // 图片路径
  success: (res) => {
    console.log('识别成功:', res);
    // res.plates 包含识别到的车牌信息数组
    // res.count 为识别到的车牌数量
  },
  fail: (err) => {
    console.error('识别失败:', err);
  }
});

3. 实时扫描识别

import { startScan } from "@/uni_modules/zy-hyperlpr";

startScan({
  minConfidence: 0.85,    // 最低置信度
  stableFrames: 3,        // 稳定帧数
  timeout: 30000,         // 超时时间（毫秒）
  useBackCamera: true,    // 使用后置摄像头
  color: '#1b59f8',       // 扫描框颜色
  onEvent: (event) => {
    switch (event.event) {
      case 'started':
        console.log('预览页已启动');
        break;
      case 'result':
        console.log('识别成功:', event.plate);
        break;
      case 'cancel':
        console.log('用户取消');
        break;
      case 'timeout':
        console.log('识别超时');
        break;
      case 'error':
        console.log('识别错误:', event.message);
        break;
    }
  },
  success: (res) => {
    console.log('最终识别结果:', res);
    // res.plate 车牌信息
    // res.image 识别图片base64
  },
  fail: (err) => {
    console.error('启动扫描失败:', err);
  }
});

4. 释放资源

import { releaseHyperLPR } from "@/uni_modules/zy-hyperlpr";

releaseHyperLPR({
  success: (res) => {
    console.log('释放成功');
  },
  fail: (err) => {
    console.error('释放失败:', err);
  }
});

返回数据结构

车牌信息 (HyperLPRPlateInfo)

识别结果 (HyperLPRRecognizeResult)

扫描结果 (HyperLPRScanResult)

权限要求

插件需要以下权限：

• android.permission.CAMERA - 相机权限（实时扫描需要）
• android.permission.READ_EXTERNAL_STORAGE - 读取存储权限（图片识别需要）

错误码

支持的车牌类型

• 蓝色车牌（普通燃油车）
• 绿色车牌（新能源汽车）
• 黄色车牌（大型车辆）
• 白色车牌（军警车辆）
• 黑色车牌（涉外车辆）

注意事项

1. 首次使用需要先调用 initHyperLPR 初始化SDK
2. 实时扫描需要使用自定义基座或云打包
3. 识别结果会自动释放监听器，无需手动管理
4. 建议在App退出时调用 releaseHyperLPR 释放资源
5. 识别速度与设备性能相关，毫秒级响应

许可证

MIT License