一、获取SDK
1.进入ArcFace2.0的申请地址
https://ai.arcsoft.com.cn/product/arcface.html
2.填写信息申请并提交
申请通过后即可下载SDK,查看APP_ID和SDK_KEY
二、功能介绍
【虹软人脸识别ArcFace2.0|虹软人脸识别ArcFace2.0 Android SDK使用教程】虹软ArcFace 2.0 Android包含人脸检测、年龄信息检测、性别信息检测、人脸三维角度检测、活体检测、人脸特征提取、人脸特征比对功能。
其中暴露对外的功能方法有:
active(激活)
init(初始化)
detectFaces(人脸检测)
process(活体检测、年龄检测、性别检测、人脸三维角度检测功能使用该方法,以或运算组合形式选择处理的功能,并以getXXXXX方法获取处理的结果)
extractFaceFeature(特征提取)
compareFaceFeature(特征比对)
unInit(销毁)
三、使用SDK
1.创建工程,并将下载解压出的jar和so添加到工程
文章图片
image 2.激活引擎
FaceEngine faceEngine = new FaceEngine();
//激活方法首次调用有网络和文件操作,后续只有文件操作,但是一般情况下都很快int activeCode = faceEngine.active(SettingsActivity.this, Constants.APP_ID, Constants.SDK_KEY);
if (activeCode == ErrorInfo.MOK || activeCode == ErrorInfo.MERR_ASF_ALREADY_ACTIVATED) {//激活成功或者已激活过的情况}else{//激活失败的情况}faceEngine = new FaceEngine();
int afCode = faceEngine.init(context.getApplicationContext(), FaceEngine.ASF_DETECT_MODE_VIDEO, FaceEngine.ASF_OP_0_HIGHER_EXT16, 10, FaceEngine.ASF_FACE_RECOGNITION | FaceEngine.ASF_FACE_DETECT | FaceEngine.ASF_FACE3DANGLE|....);
if (afCode != ErrorInfo.MOK) {//初始化成功}else{//初始化失败}List faceInfoList = new ArrayList<>();
int code = faceEngine.detectFaces(nv21, width, height, FaceEngine.CP_PAF_NV21, faceInfoList);
if (code == ErrorInfo.MOK && faceInfoList.size() >0) {//人脸检测成功并且检测到了人脸的情况}else{//人脸检测失败或未检测到人脸的情况}FaceFeature faceFeature = new FaceFeature();
int code = faceEngine.extractFaceFeature(nv21, width, height, FaceEngine.CP_PAF_NV21, faceInfo, faceFeature);
if (code == ErrorInfo.MOK) {//特征提取成功}else{//特征提取失败,可根据code查看原因}public void compareFace(FaceFeature faceFeature1,FaceFeature faceFeature2){FaceSimilar faceSimilar = new FaceSimilar();
int code = faceEngine.compareFaceFeature(faceFeature1, faceFeature2, faceSimilar);
if (code == ErrorInfo.MOK){//比对成功,可查看faceSimilar中的相似度}else{//比对失败,可根据code查看原因}}int faceProcessCode = faceEngine.process(nv21, width, height, FaceEngine.CP_PAF_NV21, faceInfoList, FaceEngine.ASF_AGE | FaceEngine.ASF_GENDER | FaceEngine.ASF_FACE3DANGLE | FaceEngine.ASF_LIVENESS);
if (faceProcessCode != ErrorInfo.MOK){//失败的情况}else{//process成功,可获取结果List ageInfoList = new ArrayList<>();
List genderInfoList = new ArrayList<>();
List face3DAngleList = new ArrayList<>();
List faceLivenessInfoList = new ArrayList<>();
int ageCode = faceEngine.getAge(ageInfoList);
int genderCode = faceEngine.getGender(genderInfoList);
int face3DAngleCode = faceEngine.getFace3DAngle(face3DAngleList);
int livenessCode = faceEngine.getLiveness(faceLivenessInfoList);
//错误码校验,判断是否全部成功if ((ageCode | genderCode | face3DAngleCode | livenessCode) != ErrorInfo.MOK) {return;
}else{//全部检测成功,可从ageInfoList ,genderInfoList ,face3DAngleList ,faceLivenessInfoList 中获取检测结果}}if (faceEngine != null) {int faceEngineCode = faceEngine.unInit();
Log.i(TAG, "unInitEngine: " + faceEngineCode);
}线程不安全的,且调用过程中不能进行销毁。