⼈脸识别技术采⽤虹软开放平台实现(免费使⽤)。
官⽹:https://www.arcsoft.com.cn/
使⽤虹软平台需要先注册开发者账号:https://ai.arcsoft.com.cn/ucenter/user/userlogin
注册完成后进⾏登录,然后进⾏创建应⽤:
创建完成后,需要进⾏实名认证,否则相关的SDK是不能使⽤的。
实名认证后即可下载对应平台的SDk,我们需要下载windows以及linux平台。
添加SDK(Linux与Windows平台):
注意这里创建的应用上的SDK和我们注册成功后的账号是一一对应关系,也就是说,自己创建的应用SDK只能自己使用,别的账号是不可以使用的。
接下来我们下载SDK,打开解压包,可以看到有提供相应的jar包以及示例代码:
需要特别说明的是:每个账号的SDK包不通⽤,所以⾃⼰要下载⾃⼰的SDK包。
我们首先来看一下下载的SDK包当中的依赖库
我们需要将这些依赖库放在我们配置的一个目录当中
进⼊到libs⽬录,需要将arcsoft-sdk-face-3.0.0.0.jar安装到本地仓库:
- mvn install:install-file -DgroupId=com.arcsoft.face -DartifactId=arcsoft-sdk-face -Dversion=3.0.0.0 -Dpackaging=jar -Dfile=arcsoft-sdk-face-3.0.0.0.jar
-
安装成功后,在项目代码当中即可通过maven坐标引⽤了:
代码添加处1
- <dependency>
- <groupId>com.arcsoft.face</groupId>
- <artifactId>arcsoft-sdk-face</artifactId>
- <version>3.0.0.0</version>
- <!--<scope>system</scope>-->
- <!--如果没有安装到本地仓库,可以将jar包拷贝到工程的lib下面下,直接引用-->
- <!--<systemPath>${project.basedir}/lib/arcsoft-sdk-face-3.0.0.0.jar</systemPath>-->
- </dependency>
-
开始使⽤
说明:虹软的SDK是免费使⽤的,但是⾸次使⽤时需要联⽹激活,激活后可离线使⽤。使⽤周期为1年,1年后需要联⽹再次激活。个⼈免费激活SDK总数量为100。
代码添加处2
代码当中配置文件:application.properties
- #虹软相关配置(在虹软应⽤中找到对应的参数)
- arcsoft.appid=*****
- arcsoft.sdkKey=****
- arcsoft.libPath=F:\\code\\WIN64
-
我们查看SDK安装包下的实例代码
- import com.arcsoft.face.*;
- import com.arcsoft.face.enums.*;
- import com.arcsoft.face.toolkit.ImageInfo;
-
- import java.io.File;
- import java.util.ArrayList;
- import java.util.List;
-
- import com.arcsoft.face.toolkit.ImageInfoEx;
-
- import static com.arcsoft.face.toolkit.ImageFactory.getGrayData;
- import static com.arcsoft.face.toolkit.ImageFactory.getRGBData;
-
-
- public class FaceEngineTest {
-
-
- public static void main(String[] args) {
-
- //从官网获取
- String appId = "";
- String sdkKey = "";
-
-
- FaceEngine faceEngine = new FaceEngine("D:\\arcsoft_lib");
- //激活引擎
- int errorCode = faceEngine.activeOnline(appId, sdkKey);
-
- if (errorCode != ErrorInfo.MOK.getValue() && errorCode != ErrorInfo.MERR_ASF_ALREADY_ACTIVATED.getValue()) {
- System.out.println("引擎激活失败");
- }
-
-
- ActiveFileInfo activeFileInfo=new ActiveFileInfo();
- errorCode = faceEngine.getActiveFileInfo(activeFileInfo);
- if (errorCode != ErrorInfo.MOK.getValue() && errorCode != ErrorInfo.MERR_ASF_ALREADY_ACTIVATED.getValue()) {
- System.out.println("获取激活文件信息失败");
- }
-
- //引擎配置
- EngineConfiguration engineConfiguration = new EngineConfiguration();
- engineConfiguration.setDetectMode(DetectMode.ASF_DETECT_MODE_IMAGE);
- engineConfiguration.setDetectFaceOrientPriority(DetectOrient.ASF_OP_ALL_OUT);
- engineConfiguration.setDetectFaceMaxNum(10);
- engineConfiguration.setDetectFaceScaleVal(16);
- //功能配置
- FunctionConfiguration functionConfiguration = new FunctionConfiguration();
- functionConfiguration.setSupportAge(true);
- functionConfiguration.setSupportFace3dAngle(true);
- functionConfiguration.setSupportFaceDetect(true);
- functionConfiguration.setSupportFaceRecognition(true);
- functionConfiguration.setSupportGender(true);
- functionConfiguration.setSupportLiveness(true);
- functionConfiguration.setSupportIRLiveness(true);
- engineConfiguration.setFunctionConfiguration(functionConfiguration);
-
-
- //初始化引擎
- errorCode = faceEngine.init(engineConfiguration);
-
- if (errorCode != ErrorInfo.MOK.getValue()) {
- System.out.println("初始化引擎失败");
- }
-
-
- //人脸检测
- ImageInfo imageInfo = getRGBData(new File("d:\\aaa.jpg"));
- List<FaceInfo> faceInfoList = new ArrayList<FaceInfo>();
- errorCode = faceEngine.detectFaces(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), imageInfo.getImageFormat(), faceInfoList);
- System.out.println(faceInfoList);
-
- //特征提取
- FaceFeature faceFeature = new FaceFeature();
- errorCode = faceEngine.extractFaceFeature(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), imageInfo.getImageFormat(), faceInfoList.get(0), faceFeature);
- System.out.println("特征值大小:" + faceFeature.getFeatureData().length);
-
- //人脸检测2
- ImageInfo imageInfo2 = getRGBData(new File("d:\\ccc.jpg"));
- List<FaceInfo> faceInfoList2 = new ArrayList<FaceInfo>();
- errorCode = faceEngine.detectFaces(imageInfo2.getImageData(), imageInfo2.getWidth(), imageInfo2.getHeight(),imageInfo.getImageFormat(), faceInfoList2);
- System.out.println(faceInfoList);
-
- //特征提取2
- FaceFeature faceFeature2 = new FaceFeature();
- errorCode = faceEngine.extractFaceFeature(imageInfo2.getImageData(), imageInfo2.getWidth(), imageInfo2.getHeight(), imageInfo.getImageFormat(), faceInfoList2.get(0), faceFeature2);
- System.out.println("特征值大小:" + faceFeature.getFeatureData().length);
-
- //特征比对
- FaceFeature targetFaceFeature = new FaceFeature();
- targetFaceFeature.setFeatureData(faceFeature.getFeatureData());
- FaceFeature sourceFaceFeature = new FaceFeature();
- sourceFaceFeature.setFeatureData(faceFeature2.getFeatureData());
- FaceSimilar faceSimilar = new FaceSimilar();
-
- errorCode = faceEngine.compareFaceFeature(targetFaceFeature, sourceFaceFeature, faceSimilar);
-
- System.out.println("相似度:" + faceSimilar.getScore());
-
- //设置活体测试
- errorCode = faceEngine.setLivenessParam(0.5f, 0.7f);
- //人脸属性检测
- FunctionConfiguration configuration = new FunctionConfiguration();
- configuration.setSupportAge(true);
- configuration.setSupportFace3dAngle(true);
- configuration.setSupportGender(true);
- configuration.setSupportLiveness(true);
- errorCode = faceEngine.process(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), imageInfo.getImageFormat(), faceInfoList, configuration);
-
-
- //性别检测
- List<GenderInfo> genderInfoList = new ArrayList<GenderInfo>();
- errorCode = faceEngine.getGender(genderInfoList);
- System.out.println("性别:" + genderInfoList.get(0).getGender());
-
- //年龄检测
- List<AgeInfo> ageInfoList = new ArrayList<AgeInfo>();
- errorCode = faceEngine.getAge(ageInfoList);
- System.out.println("年龄:" + ageInfoList.get(0).getAge());
-
- //3D信息检测
- List<Face3DAngle> face3DAngleList = new ArrayList<Face3DAngle>();
- errorCode = faceEngine.getFace3DAngle(face3DAngleList);
- System.out.println("3D角度:" + face3DAngleList.get(0).getPitch() + "," + face3DAngleList.get(0).getRoll() + "," + face3DAngleList.get(0).getYaw());
-
- //活体检测
- List<LivenessInfo> livenessInfoList = new ArrayList<LivenessInfo>();
- errorCode = faceEngine.getLiveness(livenessInfoList);
- System.out.println("活体:" + livenessInfoList.get(0).getLiveness());
-
-
- //IR属性处理
- ImageInfo imageInfoGray = getGrayData(new File("d:\\IR_480p.jpg"));
- List<FaceInfo> faceInfoListGray = new ArrayList<FaceInfo>();
- errorCode = faceEngine.detectFaces(imageInfoGray.getImageData(), imageInfoGray.getWidth(), imageInfoGray.getHeight(), imageInfoGray.getImageFormat(), faceInfoListGray);
-
- FunctionConfiguration configuration2 = new FunctionConfiguration();
- configuration2.setSupportIRLiveness(true);
- errorCode = faceEngine.processIr(imageInfoGray.getImageData(), imageInfoGray.getWidth(), imageInfoGray.getHeight(), imageInfoGray.getImageFormat(), faceInfoListGray, configuration2);
- //IR活体检测
- List<IrLivenessInfo> irLivenessInfo = new ArrayList<>();
- errorCode = faceEngine.getLivenessIr(irLivenessInfo);
- System.out.println("IR活体:" + irLivenessInfo.get(0).getLiveness());
-
- ImageInfoEx imageInfoEx = new ImageInfoEx();
- imageInfoEx.setHeight(imageInfo.getHeight());
- imageInfoEx.setWidth(imageInfo.getWidth());
- imageInfoEx.setImageFormat(imageInfo.getImageFormat());
- imageInfoEx.setImageDataPlanes(new byte[][]{imageInfo.getImageData()});
- imageInfoEx.setImageStrides(new int[]{imageInfo.getWidth() * 3});
- List<FaceInfo> faceInfoList1 = new ArrayList<>();
- errorCode = faceEngine.detectFaces(imageInfoEx, DetectModel.ASF_DETECT_MODEL_RGB, faceInfoList1);
-
- FunctionConfiguration fun = new FunctionConfiguration();
- fun.setSupportAge(true);
- errorCode = faceEngine.process(imageInfoEx, faceInfoList1, functionConfiguration);
- List<AgeInfo> ageInfoList1 = new ArrayList<>();
- int age = faceEngine.getAge(ageInfoList1);
- System.out.println("年龄:" + ageInfoList1.get(0).getAge());
-
- FaceFeature feature = new FaceFeature();
- errorCode = faceEngine.extractFaceFeature(imageInfoEx, faceInfoList1.get(0), feature);
-
-
- //引擎卸载
- errorCode = faceEngine.unInit();
-
- }
- }
-
上面的示例代码当中有许多功能,例如 人脸检测 年龄检测 性别检测 IR活体检测 活体检测…而我们现在只使用人脸检测相关功能
- //人脸检测
- ImageInfo imageInfo = getRGBData(new File("d:\\aaa.jpg"));
- List<FaceInfo> faceInfoList = new ArrayList<FaceInfo>();
- errorCode = faceEngine.detectFaces(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), imageInfo.getImageFormat(), faceInfoList);
- System.out.println(faceInfoList);
-
代码添加处3
- @Service
- public class FaceEngineService {
-
- private static final Logger LOGGER = LoggerFactory.getLogger(FaceEngineService.class);
-
- @Value("${arcsoft.appid}")
- private String appid;
-
- @Value("${arcsoft.sdkKey}")
- private String sdkKey;
-
- @Value("${arcsoft.libPath}")
- private String libPath;
-
- private FaceEngine faceEngine;
-
- @PostConstruct
- public void init() {
- // 激活并且初始化引擎
- FaceEngine faceEngine = new FaceEngine(libPath);
- int activeCode = faceEngine.activeOnline(appid, sdkKey);
- if (activeCode != ErrorInfo.MOK.getValue() && activeCode != ErrorInfo.MERR_ASF_ALREADY_ACTIVATED.getValue()) {
- LOGGER.error("引擎激活失败");
- throw new RuntimeException("引擎激活失败");
- }
-
- //引擎配置
- EngineConfiguration engineConfiguration = new EngineConfiguration();
- //IMAGE检测模式,用于处理单张的图像数据
- engineConfiguration.setDetectMode(DetectMode.ASF_DETECT_MODE_IMAGE);
- //人脸检测角度,全角度
- engineConfiguration.setDetectFaceOrientPriority(DetectOrient.ASF_OP_ALL_OUT);
-
- //功能配置
- FunctionConfiguration functionConfiguration = new FunctionConfiguration();
- functionConfiguration.setSupportAge(true);
- functionConfiguration.setSupportFace3dAngle(true);
- functionConfiguration.setSupportFaceDetect(true);
- functionConfiguration.setSupportFaceRecognition(true);
- functionConfiguration.setSupportGender(true);
- functionConfiguration.setSupportLiveness(true);
- functionConfiguration.setSupportIRLiveness(true);
- engineConfiguration.setFunctionConfiguration(functionConfiguration);
-
- //初始化引擎
- int initCode = faceEngine.init(engineConfiguration);
-
- if (initCode != ErrorInfo.MOK.getValue()) {
- LOGGER.error("初始化引擎出错!");
- throw new RuntimeException("初始化引擎出错!");
- }
-
- this.faceEngine = faceEngine;
- }
-
- /**
- * 检测图片是否为人像
- *
- * @param imageInfo 图像对象
- * @return true:人像,false:非人像
- */
- public boolean checkIsPortrait(ImageInfo imageInfo) {
- // 定义人脸列表
- List<FaceInfo> faceInfoList = new ArrayList<FaceInfo>();
- faceEngine.detectFaces(imageInfo.getImageData(), imageInfo.getWidth(), imageInfo.getHeight(), ImageFormat.CP_PAF_BGR24, faceInfoList);
- return !faceInfoList.isEmpty();
- }
-
- public boolean checkIsPortrait(byte[] imageData) {
- return this.checkIsPortrait(ImageFactory.getRGBData(imageData));
- }
-
- public boolean checkIsPortrait(File file) {
- return this.checkIsPortrait(ImageFactory.getRGBData(file));
- }
-
- }
-
-
- #问题:
- Caused by: java.lang.UnsatisfiedLinkError:
- D:\gongju\renlian\haha\libs\WIN64\libarcsoft_face.dll: Can't find dependent
- libraries
-
- 解决:
- 安装资料中的:vcredist_x64.exe,即可解决。
-
测试
- @SpringBootTest
- @RunWith(SpringJUnit4ClassRunner.class)
- public class TestFaceEngineService {
-
- @Autowired
- private FaceEngineService faceEngineService;
-
- @Test
- public void testCheckIsPortrait(){
- //导入本地的一张带有人像的图片和一张非人像的图片进行分别测试
- //人像图片
- //File file = new File("D:\\相关图片\\me.jpg");
- //非人像图片
- File file = new File("D:\\相关图片\\1.jpg");
- boolean checkIsPortrait = this.faceEngineService.checkIsPortrait(file);
- System.out.println(checkIsPortrait); // true|false
- }
- }
-