更新记录

1.0.0（2026-01-29） 下载此版本

新增

• 初始版本发布
• 支持 OCR 文字识别功能
• 基于华为 Core Vision Kit 实现
• 支持多语言识别（简体中文、英文、日文、韩文、繁体中文）
• 支持文本朝向检测
• 支持文本块位置信息和置信度返回

平台兼容性

uni-app(4.81)

jack-ocr

OCR 文字识别插件，基于华为 Core Vision Kit，支持 HarmonyOS 平台。

功能特性

• ✅ 支持图片文字识别
• ✅ 支持多语言识别（简体中文、英文、日文、韩文、繁体中文）
• ✅ 支持文本朝向检测
• ⚠️ 文本块位置信息（当前版本暂不支持，华为 API 限制）
• ⚠️ 置信度返回（当前版本暂不支持，华为 API 限制）

注意：根据华为 Core Vision Kit 文档，TextRecognitionResult 只返回识别的文本字符串（value 属性），不包含详细的文本块信息。如需更详细的信息，可能需要使用其他华为 AI 服务。

平台支持

安装

将插件导入到项目的 uni_modules 目录即可。

使用方法

方式1：使用 import 导入（推荐）

<script>
// #ifdef APP-HARMONY
import { ocrInit, ocrRecognize, ocrRelease } from '@/uni_modules/jack-ocr'
// #endif

export default {
  onLoad() {
    // 初始化 OCR
    // #ifdef APP-HARMONY
    ocrInit({
      success: (res) => {
        console.log('初始化成功', res)
      },
      fail: (err) => {
        console.error('初始化失败', err)
      }
    })
    // #endif
  },

  methods: {
    recognizeImage() {
      // 识别图片
      // #ifdef APP-HARMONY
      ocrRecognize({
        imagePath: '/path/to/image.jpg',
        isDirectionDetectionSupported: false,
        success: (res) => {
          console.log('识别结果:', res.text)
          console.log('文本块:', res.blocks)
        },
        fail: (err) => {
          console.error('识别失败', err)
        }
      })
      // #endif
    }
  },

  onUnload() {
    // 释放资源
    // #ifdef APP-HARMONY
    ocrRelease({
      success: (res) => {
        console.log('释放成功', res)
      }
    })
    // #endif
  }
}
</script>

方式2：挂载到 uni 对象

如果需要使用 uni.ocrInit() 的方式，需要在任意页面中引入一次：

import "@/uni_modules/jack-ocr"

然后就可以使用：

uni.ocrInit({ ... })
uni.ocrRecognize({ ... })
uni.ocrRelease({ ... })

API 说明

ocrInit(options)

初始化 OCR 服务。

参数说明：

ocrRecognize(options)

识别图片中的文字。

参数说明：

success 返回参数：

blocks 数组元素说明：

ocrRelease(options)

释放 OCR 服务资源。

参数说明：

错误码

注意事项

1. 使用前必须先调用 ocrInit 初始化服务
2. 页面销毁时建议调用 ocrRelease 释放资源
3. 支持的图片格式：JPEG、JPG、PNG
4. 建议图片分辨率：720p 以上
5. 图片尺寸限制：100px < 高度 < 15210px，100px < 宽度 < 10000px
6. 文本长度：不超过 10000 字符
7. 拍摄角度建议：与文本平面垂直方向夹角小于 30 度