Android-SDK4.1.5

更新时间：2023-06-29

如果您的需求是与人脸比对、人脸实名认证、在线图片活体检测API搭配使用，请创建APP方案获取最新5.2版本实名认证方案SDK及示例工程。

1.简介

1.1 功能介绍

百度人脸离线采集SDK Android 版是一种面向 Android 移动设备人脸技术开发包，此版SDK包含人脸检测、活体识别等功能，以aar包+动态链接库的形式发布。基于该方案，开发者可以轻松的构建包含人脸检测、采集和活体识别的应用。在您使用SDK之前，我们首先为您介绍以下SDK本身及相关人脸能力，以便您能更方便使用人脸采集服务。

此版SDK所包含的能力如下：

离线动作活体检测：通过让用户做出指定人脸配合式的交互动作，识别当前操作者是否为活体，此功能为离线使用，可设定指定动作是否使用及应用顺序。动作包含：眨眨眼、张闭嘴、向左摇头、向右摇头、向上抬头，向下低头6个。可有效抵御高清图片、3D建模、视频等攻击。
离线人脸质量检测：判断视频流中的图片帧中，哪些图片质量较佳，即人脸图像特征清晰（满足姿态角、光照、模糊度、遮挡等校验）。
离线人脸图像采集：通过本地SDK能力，采集人脸图像，同时经过人脸质量检测，确保采集到的人脸图像符合各条件校验（满足姿态角、光照、模糊度、遮挡等校验），为设备前端获取有效可分析人脸的主要功能。
离线授权：SDK的授权判断，授权介质也称为license，在SDK使用中，优先验证本地离线鉴权文件，验证通过可离线使用；在本地鉴权失败情况下需要向授权服务器发起请求，远程拉取授权进行验证。

此版SDK全部功能为离线版本，所有功能均本地化使用，主要用于在客户端（Android）获取人脸，实际业务使用中，可以按照业务需要，配合在线API完成全流程的业务集成。

业务流程

为了方便您的开发，我们已经为您准备了【人脸实名认证】场景的示例工程，您可以根据业务需要，创建APP方案后进行直接下载。

1.2 兼容性

系统：支持 Android 5.1(API Level 22)及以上系统。需要开发者通过 minSdkVersion来保证支持系统的检测。

机型：手机（不支持横屏或后置摄像头）

构架：支持 CPU架构平台【armeabi-v7a、arm64-v8a】

网络：支持 WIFI 及移动网络。

1.3 开发包说明

文件/文件夹名	说明
/faceplatform-release	SDK lib库、模型文件以及采集逻辑代码打包的aar
/faceplatform-ui	SDK的UI库，封装采集和动作活体UI等功能，以及各平台的so库。so包含以下几个平台如果关注包大小，请自行删减。【armeabi-v7a、arm64-v8a】
/app	DEMO工程（包含首页面、采集成功失败页面、设置页面等）

2.集成指南

本章将进行 Step-By-Step的讲解,如何快速的集成 人脸Sdk到现有应用中。一个完整的Demo 请参考开发包中的示例程序 FacePlatform。方案架构参考下图：

方案架构

2.1 准备工作

2.1.1 申请license

人脸SDK License：此license用于SDK离线功能使用，在您的申请人脸SDK的后台页面，全局->产品服务->人脸识别->客户端SDK申请

人脸控制台路径如下：

把脸移入框内

点击客户端SDK管理，弹出如下图：创建应用（这里创建应用是为了使用离线SDK，上面创建应用为了使用人脸在线接口，如注册、识别等）

把脸移入框内

在弹出的框中输入授权标识，选择应用类型，应用系统，以及包名、MD5签名，详情请查看输入框右边提示

把脸移入框内

2.1.2 下载SDK

把脸移入框内

下载SDK分为自动配置授权信息（创建license后就可以选择为该应用，下载后SDK自动帮您配置授权，不用下载license拷贝到工程中，初始化参数licenseID,包名也帮您配置好了）和未配置授权信息两种方式：

把脸移入框内

2.2 运行示例工程

2.2.1 运行自动配置授权信息的示例工程

该下载的示例工程，已经帮你改好了license和包名

Android Studio导入下载的示例工程
配置打包签名文件，由于SDK运行时会校验签名文件的MD5是否和申请时填入一样。为了便于debug能正常使用SDK，需要配置打包签名文件。
运行示例工程

2.2.2 运行未配置授权信息的示例工程

（1）Android Studio导入下载的示例工程

（2）下载license拷贝到工程的assets目录

（3）修改HomeActivity.java的initialize方法参数

（4）修改app->build.gradle里面的包名为申请license填入的包名，如上图安卓包名。

（5）配置打包签名文件，由于SDK运行时会校验签名文件的MD5是否和申请时填入一样。为了便于debug能正常使用SDK，需要配置打包签名文件。

（6）运行示例工程。如果无法正常体验，请查看logcat日志。是否有 FaceSDK-License LICENSE_INFO_CHECK_ERROR日志。如果有说明授权没有成功，可以查看本文档最后的常见问题进行解决。

2.3 添加SDK到工程

FaceSdk以androidstudio开发方式提供，以下介绍在android studio开发工具导入FaceSdk

（1）将开发包中的faceplatform-release库Copy 到工程根目录。

（2）将开发包中的faceplatform-ui库Copy 到工程根目录。

（3）SDK提供的了开源的faceplatform-ui库，把活体检测和人脸图像采集功能等功能进行了封装，适配了主流机型机型。如果需要使用，请添加faceplatform-ui模块到的工程中。faceplatform-ui目录结构如下图

					  ![img](https://ai.bdstatic.com/file/A22B3618EB134243ADD6A54691D28791)

（4）在build.gradle使用compile project引人faceplatform-ui库工程。

（5）Setting.gradle中include faceplatfrom-ui和facepaltfrom-release

（6）从官网下载授权文件license，复制到app/src/main/assets目录下。

（7）申请的license已经和打包签名key进行了绑定（申请时用到了签名的md5，为了便于debug模式也能调用SDK的功能，需要把debug的key改成申请license的key。

把key拷贝到项目根目录下
主appbuild.gradle android 下面添加(修改)signingConfigs相关的配置。如下图。

2.4 权限声明

名称	用途
需要动态申请的权限
android.permission.READ_EXTERNAL_STORAGE	读取手机外部存储权限
android.permission.WRITE_EXTERNAL_STORAGE	写入手机外部存储权限
android.permission.CAMERA	拍照权限
不需要动态申请的权限
android.permission.READ_PHONE_STATE	获取用户手机的 IMEI,用来唯一的标识用户
android.hardware.camera.autofocus	允许相机对焦
android.permission.INTERNET	允许访问网络
android.permission.WRITE_SETTINGS	允许修改系统设置
android.permission.WAKE_LOCK	屏幕常亮权限

2.5 混淆设置

如果工程需要做混淆处理的话，则在工程的proguard-rules.pro文件中添加如下配置：

-keep class com.baidu.vis.unified.license.** {*;}

-keep class com.baidu.liantian.** {*;}

-keep class com.baidu.baidusec.** {*;}

-keep class com.baidu.idl.main.facesdk.** {*;}

3.功能使用

3.1 人脸采集（包含动作活体）

（1）初始化SDK 参数分别表示：当前上下文、鉴权key、鉴权名称、回调参数 调用FaceSDKManager.getIntance().initialize(Context context, String licenseID, String licenseFileName, IInitCallback callback); Demo中此段代码在HomeActivity中。

（2）初始化参数设置（以下参数的配置文件在qpp->src->main->assets->quality_config.json）

        FaceConfig config = FaceSDKManager.getInstance().getFaceConfig();
        // SDK初始化已经设置完默认参数（推荐参数），也可以根据实际需求进行数值调整
        // 质量等级（0：正常、1：宽松、2：严格、3：自定义）
        // 获取保存的质量等级
        SharedPreferencesUtil util = new SharedPreferencesUtil(mContext);
        int qualityLevel = (int) util.getSharedPreference(Const.KEY_QUALITY_LEVEL_SAVE, -1);
        if (qualityLevel == -1) {
            qualityLevel = ExampleApplication.qualityLevel;
        }
        // 根据质量等级获取相应的质量值（注：第二个参数要与质量等级的set方法参数一致）
        QualityConfigManager manager = QualityConfigManager.getInstance();
        manager.readQualityFile(mContext.getApplicationContext(), qualityLevel);
        QualityConfig qualityConfig = manager.getConfig();
        if (qualityConfig == null) {
            return false;
        }
        // 设置模糊度阈值
        config.setBlurnessValue(qualityConfig.getBlur());
        // 设置最小光照阈值（范围0-255）
        config.setBrightnessValue(qualityConfig.getMinIllum());
        // 设置最大光照阈值（范围0-255）
        config.setBrightnessMaxValue(qualityConfig.getMaxIllum());
        // 设置左眼遮挡阈值
        config.setOcclusionLeftEyeValue(qualityConfig.getLeftEyeOcclusion());
        // 设置右眼遮挡阈值
        config.setOcclusionRightEyeValue(qualityConfig.getRightEyeOcclusion());
        // 设置鼻子遮挡阈值
        config.setOcclusionNoseValue(qualityConfig.getNoseOcclusion());
        // 设置嘴巴遮挡阈值
        config.setOcclusionMouthValue(qualityConfig.getMouseOcclusion());
        // 设置左脸颊遮挡阈值
        config.setOcclusionLeftContourValue(qualityConfig.getLeftContourOcclusion());
        // 设置右脸颊遮挡阈值
        config.setOcclusionRightContourValue(qualityConfig.getRightContourOcclusion());
        // 设置下巴遮挡阈值
        config.setOcclusionChinValue(qualityConfig.getChinOcclusion());
        // 设置人脸姿态角阈值
        config.setHeadPitchValue(qualityConfig.getPitch());
        config.setHeadYawValue(qualityConfig.getYaw());
        config.setHeadRollValue(qualityConfig.getRoll());
        // 设置可检测的最小人脸阈值
        config.setMinFaceSize(FaceEnvironment.VALUE_MIN_FACE_SIZE);
        // 设置可检测到人脸的阈值
        config.setNotFaceValue(FaceEnvironment.VALUE_NOT_FACE_THRESHOLD);
        // 设置闭眼阈值
        config.setEyeClosedValue(FaceEnvironment.VALUE_CLOSE_EYES);
        // 设置图片缓存数量
        config.setCacheImageNum(FaceEnvironment.VALUE_CACHE_IMAGE_NUM);
        // 设置活体动作，通过设置list，LivenessTypeEunm.Eye, LivenessTypeEunm.Mouth,
        // LivenessTypeEunm.HeadUp, LivenessTypeEunm.HeadDown, LivenessTypeEunm.HeadLeft,
        // LivenessTypeEunm.HeadRight
        config.setLivenessTypeList(ExampleApplication.livenessList);
        // 设置动作活体是否随机
        config.setLivenessRandom(ExampleApplication.isLivenessRandom);
        // 设置开启提示音
        config.setSound(ExampleApplication.isOpenSound);
        // 原图缩放系数
        config.setScale(FaceEnvironment.VALUE_SCALE);
        // 抠图宽高的设定，为了保证好的抠图效果，建议高宽比是4：3
        config.setCropHeight(FaceEnvironment.VALUE_CROP_HEIGHT);
        config.setCropWidth(FaceEnvironment.VALUE_CROP_WIDTH);
        // 抠图人脸框与背景比例
        config.setEnlargeRatio(FaceEnvironment.VALUE_CROP_ENLARGERATIO);
        // 加密类型，0：Base64加密，上传时image_sec传false；1：百度加密文件加密，上传时image_sec传true
        config.setSecType(FaceEnvironment.VALUE_SEC_TYPE);
        // 检测超时设置
        config.setTimeDetectModule(FaceEnvironment.TIME_DETECT_MODULE);
        // 检测框远近比率
        config.setFaceFarRatio(FaceEnvironment.VALUE_FAR_RATIO);
        config.setFaceClosedRatio(FaceEnvironment.VALUE_CLOSED_RATIO);
        FaceSDKManager.getInstance().setFaceConfig(config);

关于抠图内部实现方案如下图所示：

（3） startActivity(new Intent(this, FaceLivenessExpActivity.class))，开启预览。

（4）调用FaceSDKManager.getInstance().getLivenessStrategyModule()获得ILivenessStrategy对象。(该方法每次调用都会返回一个新对象).

（5）调用ILivenessStrategy.setPreviewDegree();设置预览图片的旋转角度。
调用setDetectStrategySoundEnable设置是否开启语音。
调用setDetectStrategyConfig设置，预览图的大小，人脸检测框的坐标和回调。

（6）多次调用livenessStrategy进行人脸图片采集，人脸跟踪、质量检测、动作活体检测。

（7）实现ILivenessStrategyCallback的onLivenessCompletion并处理结果。其中base64ImageCropMap为存放人脸抠图图片集，base64ImageSrcMap为存放人脸原图图片集并通过调用getBestImage()方法，通过从优到差的质量排序，获取最优的bitmap，代码如下图所示：

（8）Demo中的最优抠图或者最优原图，可以调用SecRequest类下的sendMessage(Context context, String secBase64, int secType);将加密后的base64发送到服务端，如需风控，需要把SecRequest.java下的risk_identify参数置为true。

3.2 人脸采集（不包含动作活体）

（2）初始化参数设置

        FaceConfig config = FaceSDKManager.getInstance().getFaceConfig();
        // SDK初始化已经设置完默认参数（推荐参数），也可以根据实际需求进行数值调整
        // 质量等级（0：正常、1：宽松、2：严格、3：自定义）
        // 获取保存的质量等级
        SharedPreferencesUtil util = new SharedPreferencesUtil(mContext);
        int qualityLevel = (int) util.getSharedPreference(Const.KEY_QUALITY_LEVEL_SAVE, -1);
        if (qualityLevel == -1) {
            qualityLevel = ExampleApplication.qualityLevel;
        }
        // 根据质量等级获取相应的质量值（注：第二个参数要与质量等级的set方法参数一致）
        QualityConfigManager manager = QualityConfigManager.getInstance();
        manager.readQualityFile(mContext.getApplicationContext(), qualityLevel);
        QualityConfig qualityConfig = manager.getConfig();
        if (qualityConfig == null) {
            return false;
        }
        // 设置模糊度阈值
        config.setBlurnessValue(qualityConfig.getBlur());
        // 设置最小光照阈值（范围0-255）
        config.setBrightnessValue(qualityConfig.getMinIllum());
        // 设置最大光照阈值（范围0-255）
        config.setBrightnessMaxValue(qualityConfig.getMaxIllum());
        // 设置左眼遮挡阈值
        config.setOcclusionLeftEyeValue(qualityConfig.getLeftEyeOcclusion());
        // 设置右眼遮挡阈值
        config.setOcclusionRightEyeValue(qualityConfig.getRightEyeOcclusion());
        // 设置鼻子遮挡阈值
        config.setOcclusionNoseValue(qualityConfig.getNoseOcclusion());
        // 设置嘴巴遮挡阈值
        config.setOcclusionMouthValue(qualityConfig.getMouseOcclusion());
        // 设置左脸颊遮挡阈值
        config.setOcclusionLeftContourValue(qualityConfig.getLeftContourOcclusion());
        // 设置右脸颊遮挡阈值
        config.setOcclusionRightContourValue(qualityConfig.getRightContourOcclusion());
        // 设置下巴遮挡阈值
        config.setOcclusionChinValue(qualityConfig.getChinOcclusion());
        // 设置人脸姿态角阈值
        config.setHeadPitchValue(qualityConfig.getPitch());
        config.setHeadYawValue(qualityConfig.getYaw());
        config.setHeadRollValue(qualityConfig.getRoll());
        // 设置可检测的最小人脸阈值
        config.setMinFaceSize(FaceEnvironment.VALUE_MIN_FACE_SIZE);
        // 设置可检测到人脸的阈值
        config.setNotFaceValue(FaceEnvironment.VALUE_NOT_FACE_THRESHOLD);
        // 设置闭眼阈值
        config.setEyeClosedValue(FaceEnvironment.VALUE_CLOSE_EYES);
        // 设置图片缓存数量
        config.setCacheImageNum(FaceEnvironment.VALUE_CACHE_IMAGE_NUM);
        // 设置活体动作，通过设置list，LivenessTypeEunm.Eye, LivenessTypeEunm.Mouth,
        // LivenessTypeEunm.HeadUp, LivenessTypeEunm.HeadDown, LivenessTypeEunm.HeadLeft,
        // LivenessTypeEunm.HeadRight
        config.setLivenessTypeList(ExampleApplication.livenessList);
        // 设置动作活体是否随机
        config.setLivenessRandom(ExampleApplication.isLivenessRandom);
        // 设置开启提示音
        config.setSound(ExampleApplication.isOpenSound);
        // 原图缩放系数
        config.setScale(FaceEnvironment.VALUE_SCALE);
        // 抠图宽高的设定，为了保证好的抠图效果，建议高宽比是4：3
        config.setCropHeight(FaceEnvironment.VALUE_CROP_HEIGHT);
        config.setCropWidth(FaceEnvironment.VALUE_CROP_WIDTH);
        // 抠图人脸框与背景比例
        config.setEnlargeRatio(FaceEnvironment.VALUE_CROP_ENLARGERATIO);
        // 加密类型，0：Base64加密，上传时image_sec传false；1：百度加密文件加密，上传时image_sec传true
        config.setSecType(FaceEnvironment.VALUE_SEC_TYPE);
        // 检测超时设置
        config.setTimeDetectModule(FaceEnvironment.TIME_DETECT_MODULE);
        // 检测框远近比率
        config.setFaceFarRatio(FaceEnvironment.VALUE_FAR_RATIO);
        config.setFaceClosedRatio(FaceEnvironment.VALUE_CLOSED_RATIO);
        FaceSDKManager.getInstance().setFaceConfig(config);

（3）startActivity(new Intent(this, FaceDetectExpActivity.class))，开启预览。

（4）调用FaceSDKManager.getInstance().getDetectStrategyModule()获得IDetectStrategy对象。(该方法每次调用都会返回一个新对象).

（5）调用IDetectStrategy.setPreviewDegree();设置预览图片的旋转角度。调用setDetectStrategySoundEnable设置是否开启语音。调用setDetectStrategyConfig设置，预览图的大小，人脸检测框的坐标和回调。

（6）多次调用detectStrategy进行人脸图片采集。

（7）实现IDetectStrategyCallback的onDetectCompletion并处理结果。其中base64ImageCropMap为存放人脸抠图图片集，base64ImageSrcMap为存放人脸原图图片集并通过调用getBestImage()方法，通过从优到差的质量排序，获取最优的bitmap，代码如下图所示：

3.3 质量校验设置

com.baidu.idl.face.platform.FaceConfig类用于人脸检测参数设置。

参数	名称	默认值	取值范围
minFaceSize	最小人脸阈值	200
notFaceValue	非人脸阈值	0.6f	0~1.0f
brightnessValue	图片最小光照阈值	宽松：30、正常：40、严格：60	0-255f
brightnessMaxValue	图片最大光照阈值	宽松：240、正常：220、严格：200	0-255f
blurnessValue	图像模糊阈值	宽松：0.8f、正常：0.6f、严格：0.4f	0~1.0f
occlusionLeftEyeValue	左眼遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
occlusionRightEyeValue	右眼遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
occlusionNoseValue	鼻子遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
occlusionMouthValue	嘴巴遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
occlusionLeftContourValue	左脸颊遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
occlusionRightContourValue	右脸颊遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
occlusionChinValue	下巴遮挡阈值	宽松：0.95f、正常：0.8f、严格：0.4f	0~1.0f
headPitchValue	低头抬头角度	宽松：30、正常：20、严格：15	0~45
headYawValue	左右摇头角度	宽松：30、正常：20、严格：15	0~45
headRollValue	偏头角度	宽松：30、正常：20、严格：15	0~45
eyeClosedValue	闭眼阈值	0.7f	0~1.0f
cacheImageNum	图片缓存数量	3	建议3~6

3.4 界面定制说明

3.4.1 修改faceplatform_ui界面

（1）如果SDK自带的UI和您的APP不统一，您可以自行修改FaceDetectRoundView。

（2）修改提示语音音频文件，有两种方式。

a、直接替换FaceUI工程raw下的mp3文件(faceplatform-ui->src->main->res->raw->.mp3)和string.xml(faceplatform-ui->src->main->res->values->strings.xml)。

b、FaceEnvironment 提供了setSoundId(FaceStatusNewEnum status, int soundId); 设置提示音资源。 FaceStatusNewEnum为不同的状态。soundId为资源文件所对应的resource id。

3.5 采集中的预览区域和检测区域说明

如下图所示（图中背景设置为透明了，可以看出这两个区域）：

其中： surfaceView宽高为屏幕的宽高； previewRect的宽高为手机摄像头的宽高； detectRect的宽高是以previewRect为基准计算出来的。计算方式参照FaceDetectRoundView.java的Rect getPreviewDetectRect(int w, int pw, int ph)方法

4.接口设计说明

4.1 人脸功能管理器

4.1.1创建实例

方法
```
FaceSDKManager getInstance()
```
参数
```
无
```
返回
```
人脸功能管理器
```
说明
```
创建人脸功能管理器
```

4.1.2 人脸功能管理器初始化

方法

       public void initialize(final Context context, String licenseID, String licenseFileName, IInitCallback callback)

参数

context 上下文环境，licenseID 传入申请License时获取的应用名称+_face_android后缀，licenseFileName 鉴权文件名称， callback 鉴权成功与否回调

返回
```
无
```

说明

初始化人脸检测功能。进行人脸检测功能License鉴权验证。

4.1.3 设置人脸功能控制参数

方法

       void setFaceConfig(FaceConfig config)

参数
```
config 人脸功能控制参数对象
```

返回
```
无
```

说明

设置人脸功能控制参数对象。

 FaceConfig对象参数：

      最小光照阈值
      
      最大光照阈值  

      模糊阈值

      遮挡阈值

      头部姿态角度阈值

      最小人脸检测阈值

      非人脸阈值

      人脸抠图宽高设置

      进行活体检测的动作类型列表

      超时时间设置

      检测框远近比率设置等

4.1.4 取得人脸图像采集功能接口

方法

    IDetectStrategy getDetectStrategyModule()

参数

无

返回
```
人脸图像采集功能接口
```

说明

取得人脸图像采集功能接口。人脸图像采集接口完成，解析图片人脸信息，返回检测结果。

4.1.5 取得活体检测功能接口

方法

   ILivenessStrategy getLivenessStrategyModule()

参数
```
无
```
返回
```
活体检测功能接口
```

说明

取得活体检测功能接口。活体检测功能接口完成，解析图片人脸信息，返回活体检测结果。

4.1.6 内存释放接口

方法

   void release()

参数
```
无
```
返回
```
无
```

说明

主要针对模型的释放，以减少内存

4.2 人脸图像采集器

人脸图像采集器IDetectStrategy，检测图片中人脸信息，返回人脸检测状态，完成人脸图像采集。

4.2.1 设置人脸图像采集功能参数

方法

  void setDetectStrategyConfig(Rect previewRect, Rect detectRect,IDetectStrategyCallback callback)

参数

previewRect 人脸图片大小，类型：Rect

detectRect 人脸检测区域大小，类型：Rect

callback 人脸图像采集功能状态监听器

返回
```
无
```
说明
```
设置人脸功能控制参数对象。
```

4.2.2 人脸图像采集

方法

  void detectStrategy(byte[] imageData)

参数
```
imageData 图片信息
```

返回
```
无
```

说明

检测图片中的人脸信息，完成人脸图像采集，返回检测状态和结果。

4.3 活体检测器

活体检测器LivenessStrategy，检测图片人脸信息，活体检测结果状态。

4.3.1 设置人脸功能控制参数

方法

void setLivenessStrategyConfig(

             List<LivenessTypeEnum> livenessList, 

             Rect previewRect, 

             Rect detectRect, 

             ILivenessStrategyCallback callback);

参数

livenessList 活体动作列表

 previewRect 人脸图片大小，类型：Rect

 detectRect 人脸检测区域大小，类型：Rect

 callback 人脸图像采集功能状态监听器

返回
```
无
```
说明
```
设置活体检测功能参数对象。
```

4.3.2 活体检测

方法

void livenessStrategy(byte[] imageData);

参数
```
imageData 图片信息
```
返回
```
无
```

说明

检测图片中的人脸信息，完成人脸图像采集和人脸活体检测，返回检测状态和结果。

4.4 人脸图像采集界面

人脸图像采集器界面FaceDetectActivity，包括UI界面，系统相机控制，使用人脸图像采集器IDetectStrategy处理相机采集到的图像。

4.5 活体检测界面

活体检测界面FaceLivenessActivity，包括UI界面，系统相机控制，使用活体检测器ILivenessStrategy处理相机采集到的图像，完成活体检测功能。

4.6 图片加密请求类

图片加密请求类SecRequest，里面的sendMessage方法是为了测试图片加密之后secBase64是否可以通过云端解密的一个示例代码。

5.常见问题

（1）license文件有什么用，该放在什么地方？

license文件需要申请，目的是作为sdk校验开发者的使用合法性，license文件放置位置不对或未放置license文件会导致没法使用sdk，一般应先申请license文件，并把申请得到的license文件，放置在assets目录下面。授权延期后要重新替换到SDK中，否则会因为授权过期导致无法使用。

（2）鉴权初始化的错误码对应的信息

ErrorCode	常量值	说明
SUCCESS	0	成功
LICENSE_NOT_INIT_ERROR	1	license未初始化
LICENSE_DECRYPT_ERROR	2	license数据解密失败
LICENSE_INFO_FORMAT_ERROR	3	license数据格式错误
LICENSE_KEY_CHECK_ERROR	4	license-key(api-key)校验错误
LICENSE_ALGORITHM_CHECK_ERROR	5	算法ID校验错误
LICENSE_MD5_CHECK_ERROR	6	MD5校验错误
LICENSE_DEVICE_ID_CHECK_ERROR	7	设备ID校验错误
LICENSE_PACKAGE_NAME_CHECK_ERROR	8	包名(应用名)校验错误
LICENSE_EXPIRED_TIME_CHECK_ERROR	9	过期时间不正确
LICENSE_FUNCTION_CHECK_ERROR	10	功能未授权
LICENSE_TIME_EXPIRED	11	授权已过期
LICENSE_LOCAL_FILE_ERROR	12	本地文件读取失败
LICENSE_REMOTE_DATA_ERROR	13	远程数据拉取失败
LICENSE_LOCAL_TIME_ERROR	14	本地时间校验错误
OTHER_ERROR	0xff	其他错误

（3）FaceSDK-LicenseLICENSE_INFO_CHECK_ERROR =license id

licenseID为您申请时填appname+“_face_android”。如下图demo-turnstile-face-android为license里面的licenseID, demo-turnstile-face-android1为app运行时Config.licenseID，两者必须一致