平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
√ | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | √ |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
简介
DC-CardDetect插件是基于百度文字识别SDK创建的uni插件,该插件现已支持身份证正反面识别,银行卡识别,车牌号识别。
准备
请前往百度开发平台申请账号,出于安全考虑,百度推荐使用授权文件方式进行开发者认证,请各位开发者申请应用之前务必认真阅读文档http://ai.baidu.com/docs#/OCR-Android-SDK/7bb09719。
下载License文件授权文件
应用创建成功之后,点击应用列表,选择已创建的应用对应的管理按钮,点击管理按钮
-
“下载License文件-Android(文字识别)”,将下载下来的License文件放入购买时绑定项目下的插件目录"nativeplugins/DC-CardDetect/android/assets/"中(如目录不存在请手动创建)。
-
“下载License文件-iOS(文字识别)”,将下载下来的License文件放入购买时绑定项目下的插件目录"nativeplugins/DC-CardDetect/ios/"中(如目录不存在请手动创建)。
重要:插件中自带aip.license为测试使用,切记换成申请的License,现插件开启付费,授权文件必须按照上面描述进行配置
权限
iOS 插件需要访问相册及相机权限,请在你的uni项目的`manifest.json -> App模块权限配置 中添加相应权限的描述说明;
- "NSCameraUsageDescription",
- "NSPhotoLibraryUsageDescription"
须知
百度文字识别对所有用户均提供每天有限次数的免费使用服务,如有更大需求,需开通付费。
当前插件基于网络使用,使用时请确保网络通畅。
此插件简化了拍照选取流程,对图片进行了一定的比例的压缩,减少了图片上传过程中产生的流量,提高了识别效率,减少了识别时间。
插件集成方法
使用方法
module方式使用
module方式支持身份证正反面识别,银行卡识别及车牌号识别,此方式需要用户手动点击拍照按钮。
引用方式
const card = uni.requireNativePlugin('DC-CardRecognize');
DC-CardRecognize方法说明
startRecognize(options,callback)
点击会跳页扫描。
参数说明
参数 | 类型 | 参数说明 |
---|---|---|
options | json | 参数配置 |
callback | function | 返回识别结果 |
options{object}
参数 | 类型 | 可选参数 |
---|---|---|
maskType | String | IDCardFront(身份证正面)、IDCardBack(身份证背面)、BankCard(银行卡)、BusinessCard(名片)、LicensePlate(车牌) |
callback返回数据(数据为JSON格式,仅解释通用部分,其余部分参数不一一详释)
类型 | 说明 |
---|---|
result | error(异常)、success(成功)、recognize(识别中) |
path | 识别成功后返回的图片路径 |
使用方法
<template>
<view>
<button type="primary" @click="getIDCard()">点击识别身份证</button>
</view>
</template>
<script>
const card = uni.requireNativePlugin('DC-CardRecognize');
export default {
data() {
return {
};
},
methods: {
getIDCard() {
card.startRecognize({
maskType:"IDCardFront"
},result => {
console.log(JSON.stringify(result));
});
}
}
}
</script>
<style>
</style>
component方式使用 (仅支持android)
简介
component方式暂时只支持.nvue文件使用,component方式暂时只支持身份证正反面的自动识别,component方式使用是需指定组件宽高。
使用方法
<DCIdCardDetect class="card" ref="detect" maskType="IDCardFront" @response="datacallBack"></DCIdCardDetect>
DCIdCardDetect属性说明
属性名 | 类型 | 默认值 | 可选参数 |
---|---|---|---|
maskType | String | IDCardFront | IDCardFront、IDCardBack |
DCIdCardDetect方法说明
resumeScan()
当完成一次扫描之后,当前组件会停留在识别成功的图片界面,通过resumeScan方法恢复扫描。
需在组件中添加ref属性
使用方法:
this.$refs.detect.resumeScan();
setMaskType(maskType)
切换当前识别类型
参数 | 类型 | 可选参数 |
---|---|---|
maskType | String | IDCardFront、IDCardBack |
需在组件中添加ref属性
使用方法:
this.$refs.detect.setMaskType('idcardfront');
DCIdCardDetect事件说明:
事件名称 | 说明 | 返回类型 |
---|---|---|
response | 返回识别结果 | JSON |
后记
若插件后期使用中出现任何问题,可评论改进。
欢迎用户提供任何可行建议。
因本插件作者使用的是免费账户,所以无法测试名片,如有识别名片需求的用户发现存在异常,可评论联系修复。