ArcFace 离线SDK，包含人脸检测、性别检测、年龄检测、人脸识别、活体检测等能力，初次使用时需联网激活，激活后即可本地无网络环境下工作，可根据业务需求结合人脸识别等SDK灵活地进行应用层开发。
1.2.1 运行环境
Android armeabi-v7a
1.2.2 系统要求
支持Android 4.4 (API Level 19)及以上系统。
1.2.3 权限申明
获取设备唯一标识，用于SDK激活授权
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
允许应用联网，用于SDK联网激活授权
<uses-permission android:name="android.permission.INTERNET" />
1.2.4 支持的颜色空间格式
NV21, BGR24
1.3.1 人脸检测
对传入图像数据进行人脸检测，返回人脸位置信息和人脸在图像中的朝向信息，可用于后续的人脸分析、人脸比对操作，支持图像模式和视频流模式。
支持单人脸、多人脸检测，最多支持检测人脸数为50。
1.3.2 人脸跟踪
捕捉视频流中的人脸信息，并对人脸进行跟踪。
1.3.3 人脸属性检测
对检测到的人脸进行属性分析，支持性别、年龄的属性分析，支持图像模式和视频流模式。
1.3.4 人脸三维角度检测
检测输入图像数据指定区域人脸的三维角度信息，包含人脸三个空间角度：俯仰角（pitch）， 横滚角（roll）， 偏航角（yaw）， 支持图像模式和视频流模式。
1.3.5 人脸比对
将两个人脸进行比对，来判断是否为同一个人，返回比对相似度值。
1.3.6 活体检测
离线活体检测，基于RGB单目摄像头实现静默式识别。针对视频流/图片，通过采集人像的破绽来判断目标对象是否为活体，可有效防止照片、屏幕二次翻拍等作弊攻击。
SDK授权按设备进行授权，每台硬件设备需要一个独立的授权，此授权的校验基于设备的唯一标识，被授权的设备，初次授权时需要联网进行授权，授权成功后在有效期内可以离线运行SDK。
激活一台设备后，遇以下情况，需要重新联网激活：
--- 删除基于SDK开发的应用或删除应用数据
--- 刷新安卓系统
--- 激活一台设备后，硬件信息发生变更
2.1.1 注册为开发者
访问ArcSoft 视觉开放平台门户：https://ai.arcsoft.com.cn，注册开发者账号并登录。
2.1.2 SDK下载
创建对应的应用，并选择需要下载的SDK、对应平台即版本，确认后即可下载SDK和查看激活码。
点击【下载SDK】即可下载SDK开发包；
点击【查看激活码】即可查看所需要APPID、SDKKEY；
2.1.3 SDK包结构
2.1.4 工程配置
1. 新建一个Android Project，切换到Project视图；
2. 将libarcsoft_face.so和libarcsoft_face_engine.so添加到src->main->jniLibs->armeabi-v7a路径下；
3. 将arcsoft_face.jar放入，并依赖进工程；
方法1：
方法2：
2.1.5 调用流程
Step1：调用FaceEngine的active方法激活设备，一个设备安装后仅需激活一次，卸载重新安装后需要重新激活。
Step2：调用FaceEngine的init方法初始化SDK，初始化成功后才能进一步使用SDK的功能。
Step3：调用FaceEngine的detectFaces方法进行图像数据或预览数据的人脸检测，若检测成功，则可得到一个人脸列表。（初始化时combineMask需要ASF_FACE_DETECT）
Step4：调用FaceEngine的extractFaceFeature方法可对图像中指定的人脸进行特征提取。（初始化时combineMask需要ASF_FACE_RECOGNITION）
Step5：调用FaceEngine的compareFaceFeature方法可对传入的两个人脸特征进行比对，获取相似度。（初始化时combineMask需要ASF_FACE_RECOGNITION）
Step6：调用FaceEngine的process方法，传入不同的combineMask组合可对Age、Gender、Face3Dangle、Liveness进行检测，传入的combineMask的任一属性都需要在init时进行初始化。
Step7：调用FaceEngine的getAge、getGender、getFace3Dangle、getLiveness方法可获取年龄、性别、三维角度、活体检测结果，且每个结果在获取前都需要在process中进行处理。
Step8：调用FaceEngine的unInit方法销毁引擎。在init成功后如不unInit会导致内存泄漏。
2.2.1 Class FaceEngine
类描述：
人脸引擎类，其中定义了人脸操作相关的函数，包含SDK的授权激活、引擎初始化以及人脸处理相关方法。
具体说明见JavaDoc。
2.2.2 Class FaceInfo
类描述：
人脸信息类，用于存储人脸框以及人脸在图片中的朝向信息。
具体说明见JavaDoc。
2.2.3 Class AgeInfo
类描述：
年龄信息类，用于存储年龄信息。
具体说明见JavaDoc。
2.2.4 Class GenderInfo
类描述：
性别信息类，用于存储性别信息。
具体说明见JavaDoc。
2.2.5 Class Face3DAngle
类描述：
人脸三维角度信息类，用于存储人脸三维角度信息。
具体说明见JavaDoc。
2.2.6 Class LivenessInfo
类描述：
活体信息类，用于存储活体信息。
具体说明见JavaDoc。
2.2.7 Class FaceFeature
类描述：
人脸特征信息类，用于存储人脸特征信息。
具体说明见JavaDoc。
2.2.8 Class FaceSimilar
类描述：
人脸相似度信息类，用于人脸相似度信息。
具体说明见JavaDoc。
2.2.9 Class VersionInfo
类描述：
版本信息类，用于存储版本信息。
具体说明见JavaDoc。
2.2.10 Class ErrorInfo
类描述：
错误信息类，其中定义了引擎调用的错误码。
具体说明见JavaDoc。
2.4.1 Bitmap转换成NV21数据
/**
* Bitmap转化为ARGB数据，再转化为NV21数据
*
* @param src 传入的Bitmap，格式为{@link Bitmap.Config#ARGB_8888}
* @param width NV21图像的宽度
* @param height NV21图像的高度
* @return nv21数据
*/
public static byte[] bitmapToNv21(Bitmap src, int width, int height) {
if (src != null && src.getWidth() >= width && src.getHeight() >= height) {
int[] argb = new int[width * height];
src.getPixels(argb, 0, width, 0, 0, width, height);
return argbToNv21(argb, width, height);
} else {
return null;
}
}
/**
* ARGB数据转化为NV21数据
*
* @param argb argb数据
* @param width 宽度
* @param height 高度
* @return nv21数据
*/
private static byte[] argbToNv21(int[] argb, int width, int height) {
int frameSize = width * height;
int yIndex = 0;
int uvIndex = frameSize;
int index = 0;
byte[] nv21 = new byte[width * height * 3 / 2];
for (int j = 0; j < height; ++j) {
for (int i = 0; i < width; ++i) {
int R = (argb[index] & 0xFF0000) >> 16;
int G = (argb[index] & 0x00FF00) >> 8;
int B = argb[index] & 0x0000FF;
int Y = (66 * R + 129 * G + 25 * B + 128 >> 8) + 16;
int U = (-38 * R - 74 * G + 112 * B + 128 >> 8) + 128;
int V = (112 * R - 94 * G - 18 * B + 128 >> 8) + 128;
nv21[yIndex++] = (byte) (Y < 0 ? 0 : (Y > 255 ? 255 : Y));
if (j % 2 == 0 && index % 2 == 0 && uvIndex < nv21.length - 2) {
nv21[uvIndex++] = (byte) (V < 0 ? 0 : (V > 255 ? 255 : V));
nv21[uvIndex++] = (byte) (U < 0 ? 0 : (U > 255 ? 255 : U));
}
++index;
}
}
return nv21;
}
2.4.2 Bitmap转换成BGR数据
/**
* bitmap转化为bgr数据，格式为{@link Bitmap.Config#ARGB_8888}
*
* @param image 传入的bitmap
* @return bgr数据
*/
public static byte[] bitmapToBgr(Bitmap image) {
if (image == null) {
return null;
}
int bytes = image.getByteCount();
ByteBuffer buffer = ByteBuffer.allocate(bytes);
image.copyPixelsToBuffer(buffer);
byte[] temp = buffer.array();
byte[] pixels = new byte[(temp.length / 4) * 3];
for (int i = 0; i < temp.length / 4; i++) {
pixels[i * 3] = temp[i * 4 + 2];
pixels[i * 3 + 1] = temp[i * 4 + 1];
pixels[i * 3 + 2] = temp[i * 4];
}
return pixels;
}
阈值区间为[0~1]，建议阈值设置为0.8，可根据实际场景需求进行调整。
Q: 如何将人脸识别1:1进行开发改为1:n？
A: 先将人脸特征数据用本地文件、数据库或者其他的方式存储下来，若检测出结果需要显示图像可以保存对应的图像。之后循环对特征值进行对比，相似度最高者若超过您设置的阈值则输出相关信息。
Q: Android人脸检测结果的人脸框绘制到View上为何位置不对？
A: 人脸检测结果的人脸框位置是基于输入图像的，例如在竖屏模式下，假设View的宽高是1080x1920，相机是后置相机，并且预览数据宽高为1920x1080，有一个被检测到的人脸位置是（left,top,right,bottom），那么需要绘制到View上的Rect就是（bottom,left,1080-top,right），相当于顺时针旋转90度，其他角度可用类似的方法计算。另外，在一般情况下，安卓调用前置相机时在View上的显示的画面和实际预览数据成镜像关系。
Q: 初始化引擎时检测方向应该怎么选择？
A: SDK初始化引擎中可选择仅对0度、90度、180度、270度单角度进行人脸检测，也可选择全角度进行检测；根据应用场景，推荐使用单角度进行人脸检测，因为选择全角度的情况下，算法中会对每个角度检测一遍，导致性能相对于单角度较慢。
Q: 初始化引擎时（detectFaceScaleVal）参数多大比较合适？
A: 用于数值化表示的最小人脸尺寸，该尺寸代表人脸尺寸相对于图片长边的占比。video 模式有效值范围[2,16], Image 模式有效值范围[2,32]，多数情况下推荐值为 16，特殊情况下可根据具体场景下进行设置；
Q: 初始化引擎之后调用其他接口返回错误码86018，该怎么解决？
A: 86018即需要检测的属性未初始化，需要查看调用接口的属性有没有在初始化引擎时在combineMask参数中加入。
Q: 调用detectFaces、extractFaceFeature和process接口返回90127错误码，该怎么解决？
A: SDK对图像尺寸做了限制，宽高大于0，宽度为4的倍数，YUYV/I420/NV21/NV12格式的图片高度为2的倍数，BGR24格式的图片高度不限制；如果遇到90127请检查传入的图片尺寸是否符合要求，若不符合可对图片进行适当的裁剪。
Q: 人脸检测结果的人脸框Rect为何有时会溢出传入图像的边界？
A: Rect溢出边界可能是人脸只有一部分在图像中，算法会对人脸的位置进行估计。
Q: 为何调用引擎有时会出现crash？
A: 若在引擎调用过程中进行销毁引擎则可能会导致crash。在使用过程中应避免在销毁引擎时还在使用引擎，尤其是做特征提取或活体检测等耗时操作时销毁引擎，如加锁解决。
Q: MERR_FSDK_FACEFEATURE_LOW_CONFIDENCE_LEVEL，人脸检测结果置信度低是什么情况导致的？
A: 图片模糊或者传入的人脸框不正确。
Q：哪些因素会影响人脸检测、人脸跟踪、人脸特征提取等SDK调用所用时间？
A：硬件性能、图片质量等。