FaceFinger多生物服务使用示例（java版）

FaceFinger多生物服务使用示例（java版）

第1章 简介

1.1 开发流程

熟悉开发手册——申请账号与密码——代码开发——联调测试

1.2 访问地址

接口为符合 RESTful的 web 服务。

访问地址：

http://api.facefinger.cn:8080/ff/

1.3 环境构建



如图所示。

第2章 API使用例

2.1 人脸位置分析（/face/detect）

public static void faceDetectTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.setImg(new File(“E:\pic\10002.jpg”));

bioService.addAttribute(“num”, “10”); // 可选

bioService.addAttribute(“minFaceSize”, “30”); // 可选

bioService.addAttribute(“maxFaceSize”, “300”); // 可选

bioService.addAttribute(“detectROI”, “30, 100, 20, 110”); // 可选

JSONObject result = request.request(“face”, “detect”, bioService);

System.out.println(“faceDetectTest ” + result);

}

2.2 人脸特征点分析（/face/featurePoint）

public static void faceFeaturePointTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.setImg(new File(“E:\pic\10002.jpg”));

bioService.addAttribute(“detectROI”, “30, 100, 20, 110”); // 可选

JSONObject result = request.request(“face”, “featurePoint”, bioService);

System.out.println(“faceFeaturePointTest ” + result);

}

2.3 人脸质量分析（/face/quality）

public static void faceQualityTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.setImg(new File(“E:\pic\10002.jpg”));

bioService.addAttribute(“eyePointLeft”, “132.46681,184.12794”); // 可选

bioService.addAttribute(“eyePointRight”, “222.9986,181.43767”); // 可选

JSONObject result = request.request(“face”, “quality”, bioService);

System.out.println(“faceQualityTest ” + result);

}

2.4 人脸综合分析（/face/alignment）

public static void faceAlignmentTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.setImg(new File(“E:\pic\10002.jpg”));

bioService.addAttribute(“num”, “10”); // 可选

bioService.addAttribute(“minFaceSize”, “30”); // 可选

bioService.addAttribute(“maxFaceSize”, “300”); // 可选

bioService.addAttribute(“detectROI”, “30, 100, 20, 110”); // 可选

JSONObject result = request.request(“face”, “alignment”, bioService);

System.out.println(“faceAlignmentTest ” + result);

}

2.5 人脸验证（/face/verify）

public static void faceVerifyTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.addAttribute(“img1”, new File(“E:\pic\10001.jpg”));

bioService.addAttribute(“img2”, new File(“E:\pic\10002.jpg”));

JSONObject result = request.request(“face”, “verify”, bioService);

System.out.println(“faceVerityTest ” + result);

}

2.6 指纹验证（/finger/verify）

public static void fingerVerifyTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.addAttribute(“img1”, new File(“E:\pic\0001.bmp”));

bioService.addAttribute(“img2”, new File(“E:\pic\0002.bmp”));

JSONObject result = request.request(“finger”, “verify”, bioService);

System.out.println(“fingerVerifyTest ” + result);

}

2.7 虹膜验证（/iris/verify）

public static void irisVerifyTest() throws Exception {

HttpRequests request = new HttpRequests(url_server, app_id, app_key);

PostParameters bioService = new PostParameters();

bioService.addAttribute(“img1”, new File(“E:\pic\3.bmp”));

bioService.addAttribute(“img2”, new File(“E:\pic\4.bmp”));

JSONObject result = request.request(“iris”, “verify”, bioService);

System.out.println(“irisVerifyTest ” + result);

}

第3章 FQA

 返回“9998”错误的可能原因：

 未检测到人脸；

 人脸角度中yaw范围超出[-30,+30]，roll范围超出[-15,+15]；

 待检测区域detectROI的范围设置不合理，例如”10,10,10,10”；

 minFaceSize和maxFaceSize设置不合理；

离线SDK请搜索脸指平台，进行下载。