更新记录

0.1.0（2026-08-02）

首次发布：支持 Android 本地图片离线中文/拉丁文字识别，返回全文、文本块、矩形坐标、引擎名称和耗时；增加能力探测、并发保护和统一错误码。

平台兼容性

uni-app x(5.15)

Android 离线 OCR（本地图片文字识别）

面向 uni-app x Android 的 UTS API 插件。调用方传入已经取得访问权的本地图片路径，插件在设备端完成中文/拉丁文字识别，返回全文、文本块和矩形坐标。

• 最低 HBuilderX：5.15。
• 最低 Android：5.0（API 21）。
• OCR 引擎：Google ML Kit bundled 中文模型 16.0.1。
• 权限：插件自身不申请权限；相册选择或拍照权限由宿主业务按实际功能申请。
• 数据：插件自身不上传、保存或对外发送图片与识别文本。

快速使用

import { recognizeImage } from '@/uni_modules/wzx-offlineocr'

uni.chooseImage({
  count: 1,
  success: (chooseRes) => {
    recognizeImage({
      path: chooseRes.tempFilePaths[0],
      success: (ocrRes) => {
        console.log(ocrRes.text)
        console.log(ocrRes.blocks)
      },
      fail: (error) => console.error(error.errMsg)
    })
  }
})

API

• recognizeImage(options)：识别一张本地图片。同一时刻只执行一个识别任务。
• isSupported()：当前 Android 上下文是否可用。
• getSupportInfoSync()：返回平台、引擎、语言和支持状态。

成功结果：

{
  errMsg: 'recognizeImage:ok',
  imagePath: '/path/to/image.jpg',
  text: '识别全文',
  blocks: [
    {
      text: '文本块',
      boundingBox: { left: 12, top: 40, width: 160, height: 28 }
    }
  ],
  engine: 'mlkit-chinese-bundled',
  elapsedTime: 233
}

错误码：

• 9200001：图片路径为空。
• 9200002：图片路径不可读或不是受支持的图片。
• 9200003：Android 上下文不可用。
• 9200004：ML Kit 识别失败。
• 9200005：已有识别任务在执行。

明确边界

• 只支持 Android；不支持 iOS、鸿蒙、H5 和小程序。
• 不提供相册、拍照或实时相机 UI；请先通过 uni.chooseImage 等接口取得本地路径。
• 不做身份证、银行卡、票据或表格结构化，只返回通用 OCR 文本与文本块。
• bundled 模型会增加安装包体积；实际增量以宿主打包结果为准。
• 插件源码已通过 HBuilderX 5.15 Android 编译，OCR 核心已在 Android 15 模拟器识别内置中文测试图；提交 0.1.0 时尚未完成 DCloud 自定义基座端测，请务必先用试用版验证自己的宿主工程。
• 识别准确率取决于清晰度、文字尺寸、对焦、角度和字体，不承诺所有图片都能正确识别。

正式购买前请先用试用版在自己的 HBuilderX、Android 版本和目标图片上验证。