更新记录

1.0.1(2021-09-16)

更新说明文档


平台兼容性

Android iOS
适用版本区间:4.4 - 11.0 适用版本区间:9 - 14

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


示例预览

原生插件接入步骤:

1. 注册百度开发者,并创建应用

  • 登录百度官网,注册百度开发者

  • 进入文字识别控制台,点击[创建应用]。

  • 根据自己的需要,绑定工程的applictionId和Bundle identifier,至少要填一个。

  • 在应用详情页面下载对应平台的授权文件,该授权文件请开发者妥善保管,防止泄露。 注意:该授权文件默认文件名是''aip.license",该文件名不能改名。

  • 申请或购买免费测试资源(根据自己的场景需要选择领取)。

2. HBuilderX工程配置

  • 授权文件打包配置: 打开HBuilderX,导入uniapp或小程序工程,创建授权文件目录 在工程nativeplugins(如果没有,请自行创建)子目录创建以下两个子目录:

nativeplugins/YSCloud-OCR/android/assets

nativeplugins/YSCloud-OCR/ios

目录结构如图所示:

将之前下载的''aip.license"授权文件按不同平台拷贝至相关的目录

nativeplugins/YSCloud-OCR/android/assets/aip.license

nativeplugins/YSCloud-OCR/ios/aip.license

"aip.license"授权文件在工程中的路径如图所示:

  • 选择要接入的百度OCR原生插件:

3. 编码与规范

  • 场景代码说明:
场景代码fid 说明
105 通用文字识别(含位置信息版)
106 通用文字识别
107 通用文字识别 (高精度版)
108 通用文字识别(含位置信息高精度版)
109 通用文字识别(含生僻字版)
110 网络图片识别
111 银行卡识别
120 行驶证识别
121 驾驶证识别
122 车牌识别
123 营业执照识别
124 通用票据识别
125 护照识别
126 数字识别
127 二维码识别
128 名片识别(目前只支持安卓,IOS请用通用识别)
131 增值税发票识别
133 出租车票识别
134 车辆识别号码识别
135 火车票识别
136 行程单识别
137 机动车销售发票识别
138 车辆合格证识别
139 试卷分析和识别
140 手写文字识别
141 户口本识别
142 普通机打发票识别
132 自定义模板

4.引入模块

var ocr = uni.requireNativePlugin("YSCloud-OCR-DetectModule")

5.调用方法

  • 普通场景OCR识别

    generalDetect(functionid) {
                var module = ocr.generalDetect({
                        fid:functionid
                    }, (ret) => {
                        if(ret.code){
                            plus.nativeUI.alert(JSON.stringify(ret.content));
                        }else{
                            plus.nativeUI.toast(ret.msg);
                        }   
                });
            }
  • 身份证识别

    cardDetect(type) {
                var module = ocr.cardDetect({
                        CardType:type //0:身份证正面, 非0:身份证反面
                    }, (ret) => {
                        if(ret.code){
                            plus.nativeUI.alert(JSON.stringify(ret.content));
                        }else{
                            plus.nativeUI.toast(ret.msg);
                        }   
                });
            }
  • 识别结果处理 content:识别结果对象,根据识别场景不同,识别结果对象格式也不同,需开发者自行解析

    {
    "code":true,        //识别是否成功
    "msg"    :"OK",        //识别结果信息描述,如果识别错误,msg将返回错误代码标识
    "content" : {        //识别结果对象,根据识别场景不同,识别结果对象格式也不同,需开发者自行解析。
    
    }
    }

6.应用调试与打包

  • 自定义调试基座打包 如果app正处于开发阶段,那么打包成自定义调试基座更方便开发者调试VUE代码,支持前端代码的热重载。 配置打包参数

扫码添加技术微信支持,备注说明对应的插件名称

咨询电话: 400-008-1668 邮箱:marketing@yszyun.com

隐私、权限声明

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

android: 1. 网络访问权限: android.permission.INTERNET (网络访问,用户调用百度OCR识别服务接口) 2. 摄像头访问权限: android.permission.CAMERA (用户对被识别的文本进行图像采集) 3. 文件读取权限: android.permission.READ_EXTERNAL_STORAGE (用于读取临时数据和用于本地加载识别对象) 4. 文件写入权限: android.permission.WRITE_EXTERNAL_STORAGE (用于存储识别时产生的临时数据) ios: 1. 摄像头访问权限: NSCameraUsageDescription (访问相机,用于采集识别对象图像数据) 2. 访问相册权限 NSPhotoLibraryUsageDescription (访问相册,用于加载本地识别对象)

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

插件自身不采集任何数据,插件使用的百度文字识别SDK采集数据,请参考其官方说明:https://ai.baidu.com/ai-doc/OCR/Ckibizymu

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

暂无用户评论。

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