更新记录

1.1.0（2023-11-20）

• 新增 关闭拍照声音
• 新增 设置识别频率

1.0.2（2023-11-17）

• 解决使用次数频繁、识别区域超出范围导致的闪退的问题

1.0.1（2023-11-03）

• 解决小屏机型无法唤起摄像头的问题
• 解决小屏机型矫正区域错位的问题

平台兼容性

原生插件通用使用流程：

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

# 文档矫正插件介绍

应用场景

• 日常生活中，APP主要满足拍照和清晰度即可，但在一些特殊的业务场景中，如进件、签署、校验等提交资料的情况下，对特别是银行卡、身份证、合同、纸张文档这些资料的审核要求较高。

• 普通拍照的情况下用户必须很刻意地去摆正、调整拍摄角度及距离，甚至拍很多张，才能上传一张满意的文档效果图。还可以连续上传很多张，让审核方一个个去看，都是以防审核阶段驳回。

• 一旦被驳回，就可能又要重复这波操作，审核方也要重新审一遍，非常冗余。双方都会很煎熬，流程进展也非常缓慢，大的业务甚至会影响企业的日盈利。

• 一些手机原生相机支持文档捕捉/修正，但需要先离开APP去拍照，在相册里调整，再回到APP中的相册去选择，这样也很麻烦

该功能就是解决这一现象，减少资料驳回的时间浪费，让双方都可以轻松地完成节点，提高业务办理的效率和成功率

平台支持

Android Api 19+、iOS 13+

请求权限

摄像头

• Android：AndroidManifest.xml 中配置

  <uses-permission android:name="android.permission.CAMERA" />

• iOS：Info.plist 中配置

  <key>NSCameraUsageDescription</key>
  <string>xxxAPP需要您的同意，才能使用摄像头，以便于xxx</string>

功能一览

插件使用

无需多言，直接上使用代码

const docCorrect = uni.requireNativePlugin('doc-correct')
docCorrect.detect({
    shutterSound: true,// 是否具有拍照声音，默认 true
    recognizeMillisecond: 1000,// 识别频率（毫秒），非负，默认 1000
}, (res) => {
    this.imgPath = res.data;
})

注意：recognizeMillisecond 小于500将考验硬件性能

返回结果 res

{
    code: 'success',
    data: 'filepath'
}

获取的图片地址可直接展示

<image v-if="imgPath" :src="imgPath" mode="widthFix" width="100" />