简介
本文档提供关于活体人脸核身的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
集成了活体检测和跟权威库进行比对的能力,传入一段视频和姓名、身份证号信息即可进行验证。对录制的自拍视频进行活体检测,从而确认当前用户为真人,可防止照片、视频、静态3D建模等各种不同类型的攻击。检测为真人后,再判断该视频中的人与权威库的证件照是否属于同一个人,实现用户身份信息核实。 |
SDK API 参考
活体人脸核身
功能说明
集成了活体检测和跟权威库进行比对的能力,传入一段视频和姓名、身份证号信息即可进行验证。对录制的自拍视频进行活体检测,从而确认当前用户为真人,可防止照片、视频、静态3D建模等各种不同类型的攻击。检测为真人后,再判断该视频中的人与权威库的证件照是否属于同一个人,实现用户身份信息核实。
注意:
COS Android SDK 版本需要大于等于 v5.9.32。
示例代码
// 存储桶名称,格式为 BucketName-APPIDString bucket = "examplebucket-1250000000";LivenessRecognitionRequest request = new LivenessRecognitionRequest(bucket, "folder/document.mp4");request.idCard = "身份证号";// 设置身份证号request.name = "姓名";// 设置姓名request.livenessType = "ACTION";// 设置活体检测类型,取值:LIP/ACTION/SILENTLIP 为数字模式,ACTION 为动作模式,SILENT 为静默模式,三种模式选择一种传入request.validateData = "1,2";// 设置数字模式传参:数字验证码(1234),需先调用接口获取数字验证码动作模式传参:传动作顺序(2,1 or 1,2),需先调用接口获取动作顺序静默模式传参:空request.bestFrameNum = 1;// 设置需要返回多张最佳截图,取值范围1 - 10,不设置默认返回一张最佳截图cosXmlService.livenessRecognitionAsync(request, new CosXmlResultListener() {@Overridepublic void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {// result 活体人脸核身的结果// 详细字段请查看api文档或者SDK源码LivenessRecognitionResult result = (LivenessRecognitionResult) cosResult;}@Overridepublic void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {if (clientException != null) {clientException.printStackTrace();} else {serviceException.printStackTrace();}}});
说明: