人脸识别SDK开发说明

功能说明

• sdk型号：Antelope 100

• 支持特性：

  人脸检测/定位

  特征提取

  特征对别

  活体检测

  年龄/性别检测

  最小图片支持：40x40像素

• 授权说明：

  授权方式：按设备台数终身授权，提交授权申请时需要提供设备SN和IMEI信息。

  开发测试请联系技术支持开通。（测试授权有效期：自开通之日一个月内有效）

  正常采购请联系商务下单采购。

• 资源下载：

  请点击下载SDK开发包

  请点击下载iFace演示APP

1、 开发说明

1.1、业务流程：

1.2、开发流程：

• SDK激活
• 初始化SDK（识别、活体、属性)
• 人脸检测
• 图像质量判断
• 活体检测
• 特征提取
• 人脸特征比对
• 识别成功
• 资源释放

2、SDK 接口说明

2.1、获取SDK实例

FacePredictor mFacePredictor= FacePredictor.getInstance\(\);

public static FacePredictor getInstance();

2.2、SDK授权激活

mFacePredictor.activePredictore\(context\);

public int activePredictore(Context context, String id, String secret)

^备注. 首次执行授权激活时需要连接网络，请在执行前确保网络联通，否则会授权失败。 ↩

2.3、获取激活状态

mFacePredictor.activePredictore\(context\);

public int getActiveState(Context appCtx)

2.4、初始化识别模型

mFacePredictor.initFaceRecPredictor\(\);

public int initFaceRecPredictor()

2.5、初始化属性检测模型

mFacePredictor.initFaceAttrPredictor\(\)；//初始化属性检测模型

public int initFaceLivenessPredictor()

2.6、初始化活体检测模型

mFacePredictor.initFaceLivenessPredictor\(\)；//初始化活体检测模型

public int initFaceAttrPredictor()

2.7、释放识别模型

mFacePredictor.uninitFaceRecPredictor\(\);

public void uninitFaceRecPredictor()

2.8、释放属性检测模型

mFacePredictor.uninitFaceAttrPredictor\(\);

public void initFaceAttrPredictor()

2.9、释放活体检测模型

mFacePredictor.uninitFaceLivenessPredictor\(\);

public void uninitFaceLivenessPredictor()

2.10、人脸检测质量阈值设置

public int setFaceQualityThreshold(double threshold)

^备注. 默认值：0.8 ↩

2.11、人脸检测质量阈值查看

public double getFaceQualityThreshold()

2.12、人脸检测-Bitmap

public List<Rect> faceDetectBitmap(Bitmap bitmap, int rotate)

2.13、人脸检测-byte[]

public List<Rect> faceDetect(byte[] data, int width, int height, int rotate)

2.14、活体检测-Bitmap

public int liveDetectBitmap(Bitmap bitmap, int rotate, Rect rect, PointF[] points)

2.15、活体检测-byte[]

public int liveDetect(byte[] data, int width, int height, int rotate, Rect rect, PointF[] points)

2.16、人脸质量判断-byte[]

public int getFaceQuality(byte[] data, int width, int height, int rotate, Rect rect)

2.17、人脸质量判断-Bitmap

public int getFaceQualityBitmap(Bitmap bitmap, int rotate, Rect rect)

2.18、特征点提取-byte[]

public PointF[] getFacelandmarks(byte[] data, int width, int height, int rotate, Rect rect)

2.19、特征点提取-Bitmap

public float[] getFacelandmarksBitmap(Bitmap bitmap, int rotate, Rect rect)

2.20、特征值提取-byte[]

public float[] getFaceFeature(byte[] data, int width, int height, int rotate, PointF[] points)

2.21、特征值提取-Bitmap

float[] getFaceFeatureBitmap(Bitmap bitmap, int rotate, PointF[] points)

2.22、特征比对

public float compareFaceFeature(float[] feature1,float[] feature2)

2.23、年龄估计-byte[]

public int getAge(byte[] data, int width, int height, int rotate, PointF[] points)

2.24、年龄估计-Bitmap

int[] getAgeBitmap (Bitmap bitmap, int rotate, PointF[] points)

2.25、性别估计-byte[]

public int getGend(byte[] data, int width, int height, int rotate, PointF[] points)

2.26、性别估计-Bitmap

Int getAgeBitmap (Bitmap bitmap, int rotate, PointF[] points)

2.27、获取SDK名称

String getSDKName()

2.28、获取SDK版本号

String getVersionInfo()

2.29、开关debug

void enableDebug(boolean enable)

^备注. 打开debug时sdk开启详细日志，在调试时候使用。 ↩

3、开发集成

• 请先将厂商提供的lib库加项目依赖路径，如下图：

​ Antelope_100*.aar

• Build.gradle中加增加如下配置：

dependencies {

    implementation fileTree\(include: \['\*.jar','\*.aar'\], dir: 'libs'\)

    implementation group: 'commons-codec', name: 'commons-codec', version: '1.11'

    implementation group: 'org.apache.commons', name: 'commons-lang3', version: '3.9'

    implementation group: 'com.alibaba', name: 'fastjson', version: '1.1.72.android'
}

• AndroidManifest.xml配置权限

<uses-permission android:name="android.permission.CAMERA"/>

<uses-permission android:name="android.permission.ACCESS\_WIFI\_STATE"/>

<uses-permission android:name="android.permission.INTERNET"/>

<uses-permission android:name="android.permission.WRITE\_EXTERNAL\_STORAGE"/>

<uses-permission android:name="android.permission.READ\_EXTERNAL\_STORAGE"/>

<uses-permission android:name="android.permission.ACCESS\_NETWORK\_STATE" />

<uses-permission android:name="android.permission.READ\_PHONE\_STATE"/>

<uses-permission android:name="android.permission.READ\_PRIVILEGED\_PHONE\_STATE" />

• 需要在AndroidManifest.xml中增加如下配置方可访问网络(如下图：)

• network_security_config.xml中内容如下：

4、附录

4.1、错误代码说明