金融级实人认证服务提供UniApp插件,帮助您在您的业务应用(App)中实现刷脸认证功能。您可以通过您的应用服务端认证初始化接口,向阿里云服务器调用发起认证请求接口并获取刷脸认证的唯一标识CertifyId,然后使用CertifyId唤起刷脸认证客户端SDK。本文介绍如何通过UniApp插件接入刷脸认证。
接入前必读
近期发现有个人开发者封装阿里云增强版实人认证SDK后开发了第三方插件,并在某平台上提供付费下载服务。阿里云提醒您,如果您使用了此类非阿里云官方提供的插件或服务,阿里云概不对由此造成的一切后果负责,亦不承担任何法律责任。建议您使用阿里云官方SDK服务。
配置依赖
您可以参考DCloud官网文档接入UniApp插件,也可以参考以下步骤接入UniApp插件。
- 下载金融级实人认证UniApp SDK,解压到项目中的nativePlugins目录下。

- 导入本地插件。
- 在manifest.json文件下,单击App原生插件配置。
- 在App原生插件配置区域,单击选择本地插件。

- 在本地插件选择对话框,选择需要打包生效的插件。
- 配置基座包。
- 设置自定义调试基座。在manifest.json文件,选择。

- 制作自定义调试基座。在manifest.json文件,单击,选择制作自定义调试基座。

- 调用实人认证服务。
- 获取metaInfo数据。
您在调用刷脸认证服务端发起认证请求时需要传入该值。具体操作,请参见
发起认证请求。
- 调用verify接口,传入certifyId进行认证。
参数说明如下表所示。
名称 |
类型 |
描述 |
certifyId |
String |
认证的唯一标识。 |
returnVideo |
String |
是否返回视频(iOS)。取值:
- true:返回视频。
- false(默认):不返回视频。
|
returnVideoUpload |
String |
是否需要将返回视频上传到OSS(iOS)。取值:
- true:上传视频。
- false(默认):不上传视频。
|
ext_params_key_use_video |
String |
是否返回视频并上传到OSS(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 |
实人认证进度条颜色。 |
说明 表中的参数均为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 |
刷脸成功 |
代表刷脸成功,该结果仅供参考,可通过调用服务端DescribeFaceVerify接口获取最终认证结果。 |
1001 |
系统错误 |
表示系统错误。 |
1003 |
验证中断 |
表示验证中断。 |
2002 |
网络错误 |
表示网络错误。 |
2003 |
客户端设备时间错误 |
表示客户端设备时间错误。 |
2006 |
刷脸失败 |
表示刷脸失败,如需获取更详细的失败原因,需调用服务端DescribeFaceVerify接口获取。 |