方案集成指南

NSString *licenseFile = [[NSBundle mainBundle] pathForResource:FACE_API_ORC_KEY ofType:FACE_SECRET_OCR_KEY];
NSData *licenseFileData = [NSData dataWithContentsOfFile:licenseFile];
[[AipOcrService shardService] authWithLicenseFileData:licenseFileData];`

[[SSFaceSDKManager sharedInstance] setBCEClientId:FACE_API_KEY clientSecret:FACE_SECRET_KEY];
NSString* licensePath = [NSString stringWithFormat:@"%@.%@", FACE_LICENSE_NAME, FACE_LICENSE_SUFFIX ];
[[SSFaceSDKManager sharedInstance] setLicenseID:FACE_LICENSE_ID andLocalLicenceFile:licensePath andRemoteAuthorize:YES];
NSLog(@"canWork = %d",[[SSFaceSDKManager sharedInstance] canWork]);
NSLog(@"version = %@",[[SSFaceSDKManager sharedInstance] getVersion]);`

``[self getAccessTokenWithAK:FACE_API_KEY SK:FACE_SECRET_KEY];``

AppDelegate *appDelegate = (AppDelegate*) [[UIApplication sharedApplication] delegate];
if (![[SSFaceSDKManager sharedInstance] canWork]){
    NSLog(@"授权失败，请检测ID 和 授权文件是否可用");
    return;
}
// 设置人脸遮挡阀值
[[SSFaceSDKManager sharedInstance] setOccluThreshold:0.5];
// 设置亮度阀值
[[SSFaceSDKManager sharedInstance] setMinIllumThreshold:40];
[[SSFaceSDKManager sharedInstance] setMaxIllumThreshold:240];
// 设置图像模糊阀值
[[SSFaceSDKManager sharedInstance] setBlurThreshold:0.3];
// 初始化SDK配置参数，可使用默认配置
// 设置最小检测人脸阈值
[[SSFaceSDKManager sharedInstance] setMinFaceSize:200];
// 设置截取人脸图片高
[[SSFaceSDKManager sharedInstance] setCropFaceSizeWidth:400];
// 设置截取人脸图片宽
[[SSFaceSDKManager sharedInstance] setCropFaceSizeHeight:640];
// 设置头部姿态角度
[[SSFaceSDKManager sharedInstance] setEulurAngleThrPitch:10 yaw:10 roll:10];
// 设置人脸检测精度阀值
[[SSFaceSDKManager sharedInstance] setNotFaceThreshold:0.6];
// 设置抠图的缩放倍数
[[SSFaceSDKManager sharedInstance] setCropEnlargeRatio:2.5];
// 设置照片采集张数
[[SSFaceSDKManager sharedInstance] setMaxCropImageNum:3];
// 设置超时时间
[[SSFaceSDKManager sharedInstance] setConditionTimeout:15];
// 设置开启口罩检测，非动作活体检测可以采集戴口罩图片
[[SSFaceSDKManager sharedInstance] setIsCheckMouthMask:true];
// 设置开启口罩检测情况下，非动作活体检测口罩过滤阈值，默认0.8 不需要修改
[[SSFaceSDKManager sharedInstance] setMouthMaskThreshold:0.8f];
// 设置原始图缩放比例
[[SSFaceSDKManager sharedInstance] setImageWithScale:0.8f];
// 设置图片加密类型，type=0 基于base64 加密；type=1 基于百度安全算法加密
[[SSFaceSDKManager sharedInstance] setImageEncrypteType: 1];
// 初始化SDK功能函数

// 设置人脸过远框比例
[[SSFaceSDKManager sharedInstance] setMinRect:0.4];

// 设置图像阀值
[BDFaceAdjustParamsTool changeConfig:appDelegate.faceImageParams];
[[BDFaceActionLiveConfig sharedInstance] initActionLive];
[[SSFaceSDKManager sharedInstance] initCollect];`

[BDFaceLivingConfigModel.sharedInstance.liveActionArray addObject:@(FaceLivenessActionTypeLiveEye)];
[BDFaceLivingConfigModel.sharedInstance.liveActionArray addObject:@(FaceLivenessActionTypeLiveMouth)];
[BDFaceLivingConfigModel.sharedInstance.liveActionArray addObject:@(FaceLivenessActionTypeLiveYawRight)];
BDFaceLivingConfigModel.sharedInstance.isByOrder = NO; // 动作是否是随机顺序
BDFaceLivingConfigModel.sharedInstance.numOfLiveness = 3;`

[[SSFaceSDKManager sharedInstance] initCollect];`

- (void)livenessActionDidFinishWithCode:(LivenessRemindCode)code;`

- (void)faceSessionCompletionWithStatus:(BDFaceCompletionStatus)status result:(NSDictionary *)result;`

BDFaceCompletionStatusSuccess = 1,
BDFaceCompletionStatusNoRisk = 2, 
BDFaceCompletionStatusImagesSuccess = 3,

[[SSFaceSDKManager sharedInstance] livenesswithList:livenessArray order:order numberOfLiveness:numberOfLiveness];

- (void)livenessActionDidFinishWithCode:(LivenessRemindCode)code;

- (void)startRecognize {
[[BDFaceImageShow sharedInstance] setSuccessImage:nil];
NSDictionary *parameters =  [self.videoCapture creatFaceVerifyParameters:self.idCardNumber name:self.name verifyType:KFaceIdCardTypeDefault nation:nil phoneNumber:nil livenessControl:nil spoofingControl:nil qualityControl:nil];
[self.videoCapture startSessionWithType:BDFaceResultReportTypeVerifySec parameters:parameters faceFlow:self.faceFlowType viewController:self];
}

#import "SSFaceSDKManager.h"
#import "SSFaceDetectionManager.h"
// 参数枚举等
typedef NSString *FaceIdCardType NS_STRING_ENUM;
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypeDefault; // 默认 大陆身份证
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypeMTPIDCard; // 港澳居民来往内地通行证
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypeFPRIDCard; // 外国人永久居留身份证
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypePassport; // 定居国外的中国公民护照

// 活体检测返回状态
typedef NS_ENUM(NSUInteger, LivenessRemindCode) {
LivenessRemindCodeOK = 0,   //成功
LivenessRemindCodeBeyondPreviewFrame,    //出框
LivenessRemindCodeNoFaceDetected, //没有检测到人脸
LivenessRemindCodeMuchIllumination,
LivenessRemindCodePoorIllumination,   //光照不足
LivenessRemindCodeImageBlured,    //图像模糊
...

/**
 *  SDK云端校验设置
 *  需要云端校验，需提前申请id和secret
 *
 *  @param clientId api key
 *  @param clientSecret api secret
 */
- (void)setBCEClientId:(NSString *)clientId clientSecret:(NSString *)clientSecret;


/**
 * 设置活体动作
 * @param array 包含活体动作种类
 * @param order 是否顺序执行
 * @param numberOfLiveness 活体数量
 */
- (void)livenesswithList:(NSArray *)array order:(BOOL)order numberOfLiveness:(NSInteger)numberOfLiveness;

@interface SSFaceDetectionManager : NSObject
// 图像返回帧处理代理
@property (nonatomic, weak) id<SSCaptureDataOutputProtocol> delegate;

// 采集流程运行状态
@property (nonatomic, assign, readonly) BOOL runningStatus;

// 风险检测超时时间：-1 关闭风险检测；大于0 风险检测超时时间；0 使用默认超时时间3秒
@property (nonatomic, assign) NSInteger riskDetectionSetting;

// 设置使用镜头，前置/后置
@property (nonatomic, assign) AVCaptureDevicePosition devicePosition;

// 输出形式，AVCaptureSessionPreset类型
@property (nonatomic, copy) NSString *sessionPresent;

// 采集图像区域
@property (nonatomic, assign) CGRect previewRect;

// 探测区域
@property (nonatomic, assign) CGRect detectRect;

// 是否开启声音提醒
@property (nonatomic, assign) BOOL enableSound;


/**
 * 创建用于实名认证的参数
 */
- (NSDictionary *)creatFaceVerifyParameters:(NSString *)idCardNumber
                                   name:(NSString *)name
                             verifyType:(FaceIdCardType)cardType
                                 nation:(NSString *)nation
                            phoneNumber:(NSString *)phoneNumber
                        livenessControl:(FaceLivenessControlType)livenessControl
                        spoofingControl:(FaceSpoofingControlType)spoofingControl
                         qualityControl:(FaceQualityControlType)qualityControl;

/**
 * 创建用于人脸比对的参数
 */
- (NSDictionary *)createFaceMatchParametersWithRegisterImage:(NSString *)registerImageBase64
                                       registerImageType:(FaceRegisterImageType)registerImageType
                                        registerFaceType:(FaceFaceType)registerFaceType
                                                faceType:(FaceFaceType)faceType
                                            faceSortType:(FaceSortype)faceSortType
                                             phoneNumber:(NSString *)phoneNumber
                                         livenessControl:(FaceLivenessControlType)livenessControl
                                          qualityControl:(FaceQualityControlType)qualityControl
                                 registerLivenessControl:(FaceLivenessControlType)registerLivenessControl
                                  registerQualityControl:(FaceQualityControlType)registerQualityControl;


/**
 * 开始当前人脸校验流程
 * @param detectionType 业务流程，采集信息用于实名认证、人脸比对
 * @param parameters 流程需要的参数
 * @param flowType 操作流程，人脸采集、人脸活体
 * @param vc 用于进行人脸信息采集的ViewController
 */
- (void)startSessionWithType:(BDFaceResultReportType)detectionType parameters:(NSDictionary *)parameters faceFlow:(BDFaceFlowType)flowType viewController:(UIViewController *)vc;

/**
 * 取消当前人脸校验流程
 */
- (void)cancel;
通过startSession方法开始进行人脸采集之后，会通过SSCaptureDataOutputProtocol类型的delegate进行回调：

/**
 * 流程返回结果类型
 */
typedef NS_ENUM(NSInteger, BDFaceCompletionStatus) {
BDFaceCompletionStatusSuccess = 1,  // 成功
BDFaceCompletionStatusNoRisk = 2,   // 无风险
BDFaceCompletionStatusImagesSuccess = 3, // 图像采集成功

BDFaceCompletionStatusIsRunning = -1,   // 正在采集图像
BDFaceCompletionStatusResultFail = -2,  // 云端服务执行失败
BDFaceCompletionStatusIsRiskDevice = -3,    // 风险设备
BDFaceCompletionStatusCameraError = -5,    // 没有授权镜头
BDFaceCompletionStatusTimeout = -6, // 超时
BDFaceCompletionStatusSDKNotInit = -13, // SDK未初始化
BDFaceCompletionStatusLicenseFail = -15, // 授权错误
BDFaceCompletionStatusNetworkError = -16,    // 网络错误
};

@protocol SSCaptureDataOutputProtocol <NSObject>

// 帧图像回传，用于刷新UI使用
- (void)captureOutputSampleBuffer:(UIImage *)image;

// 本次人脸流程回调
- (void)faceSessionCompletionWithStatus:(BDFaceCompletionStatus)status result:(NSDictionary *)result;

// 活体检测状态
- (void)livenessActionDidFinishWithCode:(LivenessRemindCode)code;

// 人脸识别检测
- (void)detectionActionDidFinishWithCode:(DetectRemindCode)code;

@end

private void initOCRSDK() {
        OCR.getInstance(this).initAccessToken(new OnResultListener<AccessToken>() {
            @Override
            public void onResult(final AccessToken result) {
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        // 调用成功，返回AccessToken对象
                        String token = result.getAccessToken();
                    }
                });
            }

            @Override
            public void onError(final OCRError error) {
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        //调用失败
                        Log.d(TAG, "run: erromsg=" + error.getMessage());
                    }
                });

            }
        }, getApplicationContext());
    }

 /**
     * 开始进入身份证认证页面
     */
    private void startIdCardVerify() {
        if (mConsoleConfig.getUseOcr() == 1) {
            Intent intent = new Intent(mContext, CameraExpActivity.class);
            // 设置临时存储
            intent.putExtra(CameraActivity.KEY_OUTPUT_FILE_PATH,
                    FileUtil.getSaveFile(getApplication()).getAbsolutePath());
            // 调用拍摄身份证正面的activity
            intent.putExtra(CameraActivity.KEY_CONTENT_TYPE, CameraActivity.CONTENT_TYPE_ID_CARD_FRONT);
            intent.putExtra(CameraActivity.KEY_NATIVE_TOKEN, OCR.getInstance(this).getLicense());
            intent.putExtra(CameraActivity.KEY_NATIVE_ENABLE, true);
            startActivity(intent);
        } else {
            Intent intent = new Intent(mContext, IdCardInputActivity.class);
            startActivity(intent);
        }
    }

/**
     * 识别身份证
     */
    private void recIDCard(String idCardSide, final String filePath) {
        IDCardParams param = new IDCardParams();
        param.setImageFile(new File(filePath));
        param.setIdCardSide(idCardSide);
        param.setDetectDirection(true);
        OCR.getInstance(this).recognizeIDCard(param, new OnResultListener<IDCardResult>() {
            @Override
            public void onResult(final IDCardResult result) {
                    runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        if (result == null) {
                            return;
                        }
                        //识别成功获取值
                        Word idNumber = result.getIdNumber();
                        Word nameWord = result.getName();
                        if (idNumber != null) {
                            mIdCardNum = idNumber.getWords();
                        }

                        if (nameWord != null) {
                            mUsername = nameWord.getWords();
                        }
                    }
                });
            }

            @Override
            public void onError(final OCRError error) {
                //识别失败
            }
        });
    }

public class Config {
    // 为了apiKey,secretKey为您调用百度人脸在线接口的，如注册，比对等。
    // 为了的安全，建议放在您的服务端，端把人脸传给服务器，在服务端端
    // license为调用sdk的人脸检测功能使用，人脸识别 = 人脸检测（SDK功能）+ 人脸比对（服务端API）
    public static String apiKey = "替换为你的apiKey(ak)";
    public static String secretKey = "替换为你的secretKey(sk)";
    public static String licenseID = "替换为你的licenseID,后台SDK管理界面中，已经生成的licenseID,如:test-face-android";
    public static String licenseFileName = "替换为你的license文件名称（放于assets目录）";
}

app->build.gradle->android->signingConfigs
signingConfigs {
        def password = "替换为签名密码"
        def alias = "替换为签名别名"
        def filePath = "替换为签名文件路径"  //如  ../facesharp.jks//签名文件路径
        debug {
            keyAlias alias
            keyPassword password
            storeFile file(filePath)
            storePassword(password)
        }
        release {
            keyAlias alias
            keyPassword password
            storeFile file(filePath)
            storePassword(password)
        }
    }

 private void initLH() {
        LH.setAgreePolicy(getApplicationContext(), true);
        LH.init(getApplicationContext(),
                Config.licenseID,
                Config.apiKey,
                Config.secretKey);

    }

private void initLicense() {
    setFaceConfig();
    // 为了android和ios 区分授权，appId=appname_face_android ,其中appname为申请sdk时的应用名
    // 应用上下文
    // 申请License取得的APPID
    // assets目录下License文件名
    FaceSDKManager.getInstance().initialize(mContext, 
    Config.licenseID, Config.licenseFileName, new IInitCallback() {
            @Override
            public void initSuccess() {
            // 初始化OCR SDK 使用的license是aip.license，名字不能修改
                initOCRSDK();
            }

            @Override
            public void initFailure(final int errCode, 
            final String errMsg) {
                runOnUiThread(new Runnable() {
                   @Override
                   public void run() {
                       Log.e(TAG, "初始化失败 = " + errCode + " " + errMsg);
                       showToast("初始化失败 = " + errCode + ", " + errMsg);
                       mIsInitSuccess = false;
                   }
                });
            }
        });
    }

    /**
     * 参数配置方法
     */
    private boolean setFaceConfig() {
        FaceConfig config = FaceSDKManager.getInstance().getFaceConfig();
        mConsoleConfig = ConsoleConfigManager.getInstance(mContext).getConfig();
        if (mConsoleConfig == null) {
            return false;
        }
        // -----TODO：以下为通过console平台获取到的配置信息-----
        // 设置模糊度阈值
        config.setBlurnessValue(mConsoleConfig.getBlur());
        // 设置最小光照阈值（范围0-255）
        config.setBrightnessValue(mConsoleConfig.getIllumination());
        // 设置最大光照阈值（范围0-255）
        config.setBrightnessMaxValue(mConsoleConfig.getMaxIllumination());
        // 设置左眼遮挡阈值
        config.setOcclusionLeftEyeValue(mConsoleConfig.getLeftEyeOcclu());
        // 设置右眼遮挡阈值
        config.setOcclusionRightEyeValue(mConsoleConfig.getRightEyeOcclu());
        // 设置鼻子遮挡阈值
        config.setOcclusionNoseValue(mConsoleConfig.getNoseOcclu());
        // 设置嘴巴遮挡阈值
        config.setOcclusionMouthValue(mConsoleConfig.getMouthOcclu());
        // 设置左脸颊遮挡阈值
        config.setOcclusionLeftContourValue(mConsoleConfig.getLeftCheekOcclu());
        // 设置右脸颊遮挡阈值
        config.setOcclusionRightContourValue(mConsoleConfig.getRightCheekOcclu());
        // 设置下巴遮挡阈值
        config.setOcclusionChinValue(mConsoleConfig.getChinOcclu());
        // 设置人脸姿态角阈值
        config.setHeadPitchValue(mConsoleConfig.getPitch());
        config.setHeadYawValue(mConsoleConfig.getYaw());
        config.setHeadRollValue(mConsoleConfig.getRoll());
        // 设置活体动作，通过设置list，LivenessTypeEunm.Eye, LivenessTypeEunm.Mouth,
        // LivenessTypeEunm.HeadUp, LivenessTypeEunm.HeadDown, LivenessTypeEunm.HeadLeft,
        // LivenessTypeEunm.HeadRight, LivenessTypeEunm.HeadLeftOrRight
        config.setLivenessTypeList(mConsoleConfig.getActions());
        // 设置动作活体是否随机
        config.setLivenessRandom(mConsoleConfig.isFaceVerifyRandom());
        // 风控加密类型，0：普通版；1：加密版
        config.setSecType(mConsoleConfig.getSecType());

        // -----TODO：以下不需要通过console平台配置，需要手动修改-----
        // 设置可检测的最小人脸阈值
        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);
        // 设置开启提示音
        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：原图，1：抠图
        config.setOutputImageType(FaceEnvironment.VALUE_OUTPUT_IMAGE_TYPE);
        // 检测超时设置
        config.setTimeDetectModule(FaceEnvironment.TIME_DETECT_MODULE);
        // 检测框远近比率
        config.setFaceFarRatio(FaceEnvironment.VALUE_FAR_RATIO);
        config.setFaceClosedRatio(FaceEnvironment.VALUE_CLOSED_RATIO);
        FaceSDKManager.getInstance().setFaceConfig(config);
        return true;
    }

    public static final String EXT_USERNAME = "username";
    public static final String EXT_ID_NUMBER = "idNumber";

    // 调转到动作活体采集界面
    faceIntent.setClass(this, FaceLivenessExpActivity.class);
    faceIntent.putExtra(EXT_USERNAME, mUsername);
    faceIntent.putExtra(EXT_ID_NUMBER, mIdNumber);
    startActivity(faceIntent);

//设置是否开启语音
LH.setSoundEnable(mIsEnableSound);

protected void startPreview() {
        if (mSurfaceView != null && mSurfaceView.getHolder() != null) {
            mSurfaceHolder = mSurfaceView.getHolder();
        }
        Log.d(TAG, "name=" + sName + " ,idNumber=" + sIdNumber);
        LH.startFaceVerify(this, mSurfaceHolder, this, 5, new FaceVerifyInfo
                (sIdNumber, sName, 0, "CHN", FaceEnum.LivenessControl.NONE,
                        FaceEnum.SpoofingControl.NONE,
                        FaceEnum.QualityControl.NONE, ""), true);


    }

 String image=Base64Utils.encodeToString(
        getImageFromAssetsFile(getApplicationContext(),"ceshi.jpg"),Base64Utils.NO_WRAP);

LH.startFaceCompare(this, mSurfaceHolder, this, 5, new FaceCompareInfo
        (FaceEnum.QualityControl.NONE, FaceEnum.LivenessControl.NORMAL,
                FaceEnum.FaceType.LIVE,0,
                image,FaceEnum.ImageType.BASE64,FaceEnum.FaceType.LIVE,
                FaceEnum.QualityControl.NORMAL, FaceEnum.LivenessControl.NORMAL,""), true);
//获取assets目录下的图片             
public static byte[] getImageFromAssetsFile(Context context, String fileName) {
    byte[] result = null;
    AssetManager am = context.getResources().getAssets();
    try {
        InputStream is = am.open(fileName);
        result=new byte[is.available()];
        is.read(result);
        is.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
    return result;
}

 
    @Override
    public void onPause() {
        if (!mIsCompletion) {
            LH.cancelFaceProcess();
        }
        mIsCompletion = false;
        super.onPause();
    }

   
    @Override
    public void onEnd(final int status, String resultJson) {
        Log.e("FaceLivenessActivity", "onEnd called:" + status + "_" + resultJson);
        if (status == 1) {
            //流程正常结束
        } else {
            //流程异常结束
        }
    }