更新记录
1.0.0(2021-01-07) 下载此版本
1.0.0版本发布。预告:下一个版提供服务端unicloud版示例!
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:6.0 - 11.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:支持 | 适用版本区间:9 - 14 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
刷脸认证提供UniApp插件,帮助您在App中实现刷脸认证功能。您可通过刷脸认证的服务端认证初始化接口,获取刷脸认证的唯一标识CertifyId,并使用CertifyId唤起刷脸认证客户端SDK。本文介绍了UniApp客户端接入的操作方法。
配置依赖
参考以下步骤接入UniApp插件,或者您也可以参见DCloud官网文档接入UniApp插件。
-
下载UniApp插件包,解压到项目中的nativePlugins目录下。nativePlugins目录
-
导入本地插件。
- 在manifest.json文件下,单击App原生插件配置。
- 在App原生插件配置区域,单击选择本地插件。导入本地插件
- 在本地插件选择对话框,选择需要打包生效的插件。
-
配置基座包
- 设置自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器 > 运行基座选择,选择自定义调试基座(Android)。自定义调试基座
- 制作自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器,选择制作自定义调试基座。制作自定义调试基座
- 设置自定义调试基座。在manifest.json文件下,单击运行 > 运行到手机或模拟器 > 运行基座选择,选择自定义调试基座(Android)。自定义调试基座
-
调用实人认证服务
- 获取metaInfo数据。
- 您在调用刷脸认证服务端发起认证请求时(具体请参见发起认证请求)需要传入该值。
- 开始认证。调用verify接口,传入
certifyId
进行认证。
参数说明如下表所示
名称 | 类型 | 描述 |
---|---|---|
certifyId | string | 认证的唯一标识。 |
returnVideo | string | 是否返回视频(iOS) 取值:true:返回视频 false(默认):不返回视频 |
ext_params_key_use_video | string | 是否返回视频(Android) 取值:true:返回视频 false(默认):不返回视频 |
ext_params_key_ocr_bottom_button_color | string | OCR底部按钮的默认颜色 |
ext_params_key_ocr_bottom_button_clicked_color | string | OCR底部按钮被操作时的颜色 |
ext_params_key_ocr_face_circle_color | string | 实人认证进度条颜色 |
接入示例:
<template>
</template>
<script>
const n = uni.requireNativePlugin('AP-FaceDetectModule');
export default {
methods: {
verifyC: function() {
n.verify(
{
certifyId: this.certify
},
function(t) {
uni.showToast({
title: '返回的内容' + t,
icon: 'none'
});
}
);
},
//获取环境参数接口。
getMetaInfo: function() {
var t = n.getMetaInfo();
},
}
};
</script>
错误码说明
错误码 | 错误码文案 | 错误码描述 |
---|---|---|
1000 | 刷脸成功 | 代表刷脸成功,该结果仅供参考。您可通过服务端查询认证结果接口(具体请参见查询认证结果)获取最终认证结果。 |
1001 | 系统错误 | 表示系统错误。 |
1003 | 验证中断 | 表示验证中断。 |
2002 | 网络错误 | 表示网络错误。 |
2003 | 客户端设备时间错误 | 表示客户端设备时间错误。 |
2006 | 刷脸失败 | 表示刷脸失败。如需获取更详细的失败原因,需调用服务端查询认证结果接口获取(具体请参见查询认证结果)。 |