原生插件通用使用流程:

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

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://ask.dcloud.net.cn/article/35763
iOS 离线打包原生插件另见文档 https://ask.dcloud.net.cn/article/35764


简介

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>

    const card = uni.requireNativePlugin('DC-CardRecognize');
    export default {
        data() {
            return {
            };
        },
        methods: {
            getIDCard() {
                card.startRecognize({
                    maskType:"IDCardFront"
                },result => {
                    console.log(JSON.stringify(result));
                });
            }
        }
    }

<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

后记

若插件后期使用中出现任何问题,可评论改进。

欢迎用户提供任何可行建议。

因本插件作者使用的是免费账户,所以无法测试名片,如有识别名片需求的用户发现存在异常,可评论联系修复。

隐私、权限及商业化声明

1. 本插件需要申请的手机端权限列表:

相机权限、存储权限

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

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

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