更新记录

1.2.3(2022-11-15)

  1. 解决点击返回键返回退出后,无回调问题 (android)

1.2.2(2022-06-17)

  1. 解决概率性空指针导致闪退问题 (android)

1.2.1(2022-04-28)

  1. 增加只采集照片,不做OCR模式(Android&IOS)
查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:5.0 - 11.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 适用版本区间:9 - 15

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


概述

Android, IOS 证件OCR插件(身份证,银行卡等),如下


ocrdemo

插件的使用

对外提供接口:

/*
 * 执行OCR识别
 * @param options(JSONObject), 包括如下字段:
 *        token:从服务器端获取,只可使用一次
 *        ocrType:ocr 类型,0:身份证正面,1:身份证反面,2:银行卡,666: 不做OCR,只采集照片
 *        from:从哪儿获取数据,0:从摄像头拍摄,1:从相册选择
 * @param callback 执行结果回调,传入参数为对象result,result包括如下几个字段:
 *        code:执行状态码,0000:正常,0001:本地执行异常,0002:服务器端返回异常,0003:用户取消了操作,0004:未授予权限
 *        msg:执行结果描述
 *        requestId:请求ID(用于定位问题)
 *        data:OCR结果(执行成功才有此字段)
 *        image:拍摄/选择的照片(B64编码的字符串)
 * 上述data字段内容如下(json字符串):
 * 1. 身份证正面
    {
        "front":{
            "name":"李...", -- 姓名
            "gender":"男",  -- 性别
            "nationality":"汉", -- 民族
            "birthDay":"19930504", -- 生日
            "idNumber":"441283.....", -- 身份证号码
            "address":"广东省广州市......", -- 住址
            "portrait":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAQICAgICAg........." -- 截取身份证的照片
        }
    }
 * 2 身份证背面
  {
    "back":{
        "issuedBy":"北京海淀公安局", -- 签发机构
        "validDateStart":"2017.09.26", -- 开始有效日期
        "validDateEnd":"2037.09.26",  -- 失效日期
        "completeness":0 --身份证完整性: 0: 完整 1: 不完整,但关键信息内容区域都在图片内 2: 不完整,且有部分内容在区域外
    }
 }
 * 3 银行卡
 {
    "bankCard":{
        "number":"623058 ************", --银行卡号
        "bank":"平安银行", --银行名称
        "organization":"UNIONPAY" --银行类型
    }
}
 */

esandOcrModule.processOcr(options, callback);

其他信息

  1. 完整接入文档:https://esandinfo.yuque.com/books/share/80f28828-9ab9-45f4-a73d-b10dc6f91083?#
  2. 服务器端协议文档:https://market.aliyun.com/products/57000002/cmapi00042834.html
  3. 后端管理控制台地址: http://openali.esandcloud.com
  4. 技术支持
    微信:esand_info
    qq: 3626921591
    电话:18033076802
    邮箱:ruide.li@esandinfo.com

    wechatqrcode

隐私、权限声明

1. 本插件需要申请的系统权限列表:

"android.permission.CAMERA", "android.permission.FLASHLIGHT", "android.hardware.camera", "android.permission.READ_EXTERNAL_STORAGE", "android.permission.WRITE_EXTERNAL_STORAGE"

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件会调用摄像头拍摄照片提交服务器用于身份证识别 隐私协议详情 https://esandinfo.yuque.com/docs/share/66f4c015-32ab-4eb6-8c78-6c419cac2043?# 《用户隐私协议》

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

请参考开源项目地址的开源协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问