更新记录

1.0.1（2023-08-23）

• 新增返回识别图片路径
• 新增清除指定路径图片

1.0.0（2023-06-12）

• 初始版

平台兼容性

原生插件通用使用流程：

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

特别提醒

• 购买本插件前，请先试用，并充分自测确认满足需求之后再行购买。虚拟物品一旦购买之后无法退款。
• 如有使用上的疑问、bug，可以QQ群（345533496）反馈；
• 请在合法范围内使用，若使用本插件做非法开发，本方概不负责；
• 若是通过HBuilderX导入的示例项目，需前往manifest->基础设置->应用名称，修改项目名称不然会因为名称过长iOS端无法启动。

准备工作

• 百度文字识别创建应用，教程：https://ai.baidu.com/ai-doc/OCR/dk3iqnq51 创建应用根据项目需求选择需要识别的类型。

• 配置包名与Bundle ID（Android还需签名MD5）

• 获取AK、SK与License文件（复制AK、SK,下载License后面需要用到）

插件使用文档

1.创建文件夹

在项目根目录下创建nativeplugins文件夹购买或试用插件将下载的授权文件License 放入Android：nativeplugins/LY-BDOcr/android/assets/aip.license（Android授权文件下载下来名称是”aip-ocr.license“记得改成”aip.license“再放入文件夹），iOS：nativeplugins/LY-BDOcr/ios/aip.license，文件夹和License名称必须和这里的一致。（没有对应的文件夹自行创建）

2.选择插件打包（打自定义基座或云打包）

购买或试用该插件然后选中购买该插件项目的manifest.json 文件，选择App原生插件配置，选中云端插件，勾选插件对应的插件，配置相应的权限（见最下面”隐私、权限声明“）

3.引入插件

const bdOcr = uni.requireNativePlugin('LY-BDOcr');

4.身份验证

• 通过API Key / Secret Key验证，虽然SDK对网络传输的敏感数据进行了二次加密，但由于AK/SK是明文填写在代码中，在移动设备中可能会存在AK/SK被盗取的风险。有安全考虑的开发者可使用第二种授权方案。（使用这个方式验证可省略上面步骤1.创建文件夹导入License）

bdOcr.initAccessTokenWithAkSk({
    AK:"申请的Api Key",
    SK:"申请的Secret Key"
},res=>{
//iOS没有验证结果的回调
    if (res.status == 'success') {
        uni.showToast({
            title: '鉴权成功:'+res.msg,
            icon: 'none',
            duration: 2000
        })
    } else {
        uni.showToast({
            title: res.msg,
            icon: 'none',
            duration: 2000
        })
    }           
});

• 通过授权文件（安全模式）验证，使用该种方式验证需严格按照步骤1创建相应文件夹导入License文件

// 通过license文件验证身份（安全模式，推荐使用）
bdOcr.initAccessTokenLicenseFile(res => {
    // iOS没有验证结果回调
    if (res.status == 'success') {
        uni.showToast({
            title: '鉴权成功:'+res.msg,
            icon: 'none',
            duration: 2000
        })
    } else {
        uni.showToast({
            title: res.msg,
            icon: 'none',
            duration: 2000
        })
    }
});

5.识别

let time = new Date().getTime();
var name = time + ".jpg"
bdOcr.bdIdentification({
    ocrType:"textBasic",
    language_type:"CHN_ENG",
    resultImage: true,
    imageName: name
}, res => {
    // 识别图片Base64 resultImage=true有效
    //this.photo = res.resultImage;
    // 图片路径 --- 使用完记得删除路径下图片
    this.photo = res.imagePath;
    // 识别结果
    this.result = res.reslutInfo
});

6.清除指定路径下图片

deleteImage() {
    if (this.photo.length == 0 || this.photo == null) {
        return;
    }
    bdOcr.clearCacheWithFilePath(this.photo, res => {
        uni.showToast({
            title: res.result ? "删除成功" : "删除失败",
            icon: 'none',
            duration: 1500
        })
    })
},

• 参数说明

• ocrType识别类型

• language_type识别语言类型

示例代码

<template>
    <scroll-view scroll-y style="width: 750rpx;">
        <view class="content">
            <image :src="photo" mode="widthFix" style="width: 750rpx;margin-top: 30rpx;background-color: aquamarine;">
            </image>
            <text style="width: 750rpx;margin-top: 20rpx;">{{result}}</text>
            <button class="btn" @click="deleteImage">删除图片</button>
            <button class="btn" @click="touchAction('textBasic')">通用文字识别（基础版、不含位置信息）</button>
            <button class="btn" @click="touchAction('text')">通用文字识别（含位置信息）</button>
            <button class="btn" @click="touchAction('textAccurateBasic')">通用文字识别（高精度、不含位置信息）</button>
            <button class="btn" @click="touchAction('textAccurate')">通用文字识别（高精度、含位置信息）</button>
            <button class="btn" @click="touchAction('textEnhanced')">通用文字识别 （含生僻字）</button>

            <button class="btn" @click="touchAction('webImage')">网图识别</button>
            <button class="btn" @click="touchAction('idCardFront')">身份证正面识别</button>
            <button class="btn" @click="touchAction('localIdCardFront')">身份证正面扫描,自动识别</button>
            <button class="btn" @click="touchAction('idCardBack')">身份证背面识别</button>
            <button class="btn" @click="touchAction('localIdCardBack')">身份证背面,自动识别</button>
            <button class="btn" @click="touchAction('bankCard')">银行卡</button>

            <button class="btn" @click="touchAction('drivingLicense')">驾驶证</button>
            <button class="btn" @click="touchAction('vehicleLicense')">行驶证</button>
            <button class="btn" @click="touchAction('plateNumber')">车牌识别</button>
            <button class="btn" @click="touchAction('businessLicense')">营业执照</button>

            <button class="btn" @click="touchAction('receipt')">通用票据</button>
            <button class="btn" @click="touchAction('valueAddedTax')">增值税</button>
            <button class="btn" @click="touchAction('taxiReceipt')">出租车票</button>
            <button class="btn" @click="touchAction('vinCode')">VIN码识别</button>
            <button class="btn" @click="touchAction('trainTicket')">火车票识别</button>
            <button class="btn" @click="touchAction('numbers')">数字识别</button>
            <button class="btn" @click="touchAction('qrCode')">二维码识别</button>

            <button class="btn" @click="touchAction('household')">户口本</button>
            <button class="btn" @click="touchAction('passport')">护照</button>
            <button class="btn" @click="touchAction('writtenText')">手写文字</button>
            <button class="btn" @click="touchAction('exampleDoc')">试卷分析</button>
            <button class="btn" @click="touchAction('weightNote')">/磅单识别</button>

            <button class="btn" @click="touchAction('taxiItinerary')">网约车行程单识别</button>
            <button class="btn" @click="touchAction('medicalDetail')">医疗费用明细</button>
            <button class="btn" @click="touchAction('vehicleInvoice')">机动车销售发票</button>
            <button class="btn" @click="touchAction('invoice')">机打发票</button>
            <button class="btn" @click="touchAction('vehicleCertificate')">车辆合格证</button>

        </view>
    </scroll-view>

</template>

<script>
    // const bdOcr = uni.requireNativePlugin('YT-BDIdentificationModule');
    const bdOcr = uni.requireNativePlugin('LY-BDOcr');
    export default {
        data() {
            return {
                photo: "",
                result: ''
            }
        },
        onLoad() {
            // 通过AK,SK验证身份 initAccessTokenWithAkSk方法仅供测试使用，上线请使用initAccessToken方法
            // bdOcr.initAccessTokenWithAkSk({
            //  AK:"***",
            //  SK:"***"
            // },res=>{

            // });
            // 通过license文件验证身份（安全模式，推荐使用）
            bdOcr.initAccessTokenLicenseFile(res => {
                // iOS没有验证结果回调
                if (res.status == 'success') {
                    uni.showToast({
                        title: '鉴权成功:' + res.msg,
                        icon: 'none',
                        duration: 2000
                    })
                } else {
                    uni.showToast({
                        title: res.msg,
                        icon: 'none',
                        duration: 2000
                    })
                }
            });
        },
        methods: {
           deleteImage() {
                if (this.photo.length == 0 || this.photo == null) {
                    return;
                }
                bdOcr.clearCacheWithFilePath(this.photo, res => {
                    uni.showToast({
                        title: res.result ? "删除成功" : "删除失败",
                        icon: 'none',
                        duration: 1500
                    })
                })
            },
            touchAction(type) {
                console.log(type)
                let time = new Date().getTime();
                var name = time + ".jpg"
                bdOcr.bdIdentification({
                    ocrType: type,
                    resultImage: true,
                    imageName: name
                }, res => {
                    // 识别图片Base64 resultImage=true有效
                    // this.photo = res.resultImage;
                    // 图片路径 --- 使用完记得删除路径下图片
                    this.photo = res.imagePath;
                    // 识别结果
                    this.result = res.reslutInfo

                    uni.showToast({
                        title: res.imagePath,
                        icon: "none"
                    })
                });
            }
        }
    }
</script>

<style>
    .content {
        width: 750rpx;
        display: flex;
        flex-direction: column;
        display: flex;
        flex-direction: column;
    }

    .btn {
        margin-top: 10rpx;
    }
</style>