更新记录

1.0.0（2026-09-09）

• 初始版本
• 支持 Android 平台
• 支持身份证识别
• 支持银行卡识别
• 支持名片识别
• 支持车牌识别

平台兼容性

uni-app(4.72)

uni-app x(4.72)

腾讯文字识别 UTS 插件

基于腾讯云文字识别客户端SDK的UTS插件，支持Android平台。

功能特性

• 身份证识别（正反面）
• 银行卡识别
• 名片识别
• 车辆VIN码识别
• 车牌识别
• 驾驶证识别（正反面）
• 行驶证识别（正反面）
• 香港身份证识别
• 港澳台通行证识别
• 国际护照识别
• 港澳台居住证识别

安装

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

配置

1. 初始化SDK

import { initModule } from "@/uni_modules/zy-tencent-ocr";

initModule({
  secretId: 'your_secret_id',      // 腾讯云SecretId
  secretKey: 'your_secret_key',    // 腾讯云SecretKey
  ocrType: 'IDCardOCR_FRONT',      // 默认OCR类型
  modeType: 'OCR_DETECT_AUTO_MANUAL', // 默认业务模式
  success: (res) => {
    console.log('SDK初始化成功:', res);
  },
  fail: (err) => {
    console.error('SDK初始化失败:', err);
  }
});

2. OCR识别

import { startProcessOcr } from "@/uni_modules/zy-tencent-ocr";

startProcessOcr({
  ocrType: 'IDCardOCR_FRONT',  // 识别类型
  success: (res) => {
    console.log('识别成功:', res);
    // res.response 包含JSON格式的识别结果
  },
  fail: (err) => {
    console.error('识别失败:', err);
  }
});

3. 更新临时密钥

import { updateFederationToken } from "@/uni_modules/zy-tencent-ocr";

updateFederationToken({
  tmpSecretId: 'tmp_secret_id',
  tmpSecretKey: 'tmp_secret_key',
  token: 'token',
  success: (res) => {
    console.log('临时密钥更新成功');
  },
  fail: (err) => {
    console.error('临时密钥更新失败:', err);
  }
});

4. 获取SDK版本

import { getVersion } from "@/uni_modules/zy-tencent-ocr";

getVersion({
  success: (res) => {
    console.log('SDK版本:', res.version);
  },
  fail: (err) => {
    console.error('获取版本失败:', err);
  }
});

5. 释放资源

import { release } from "@/uni_modules/zy-tencent-ocr";

release({
  success: (res) => {
    console.log('SDK资源已释放');
  },
  fail: (err) => {
    console.error('释放资源失败:', err);
  }
});

支持的OCR类型

权限要求

插件需要以下权限：

• android.permission.CAMERA - 相机权限
• android.permission.INTERNET - 网络权限
• android.permission.READ_EXTERNAL_STORAGE - 读取存储权限
• android.permission.WRITE_EXTERNAL_STORAGE - 写入存储权限

注意事项

1. 使用前需要在腾讯云控制台开通文字识别服务并获取API密钥
2. SDK需要网络连接才能正常工作
3. 建议使用临时密钥而非固定密钥，以提高安全性
4. 在App退出时建议调用release方法释放SDK资源

错误码

许可证

MIT License