# arcsoft

**Repository Path**: whiteBoy/arcsoft

## Basic Information

- **Project Name**: arcsoft
- **Description**: springboot 整合虹软sdk3.0+resp实现流截取+人脸搜索
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2021-12-08
- **Last Updated**: 2021-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### ArcSoft 人脸模块

ArcSoft是基于虹软ArcFace 3.0版提供人脸比对、人脸查找服务。并支持resp流媒体处理

本项目虹软整合借鉴：https://github.com/chengxy-nds/ArcSoftFaceDemo

本项目RESP整合借鉴：https://my.oschina.net/u/3970172/blog/4779157
### 接口

IArcSoftService：

接口 | 描述
---|---
detectFaces         | 人脸检测，提供入参为File/InputStream/byte[]三种类型方法 
extractFaceFeature| 人脸特征提取，提供入参为File/InputStream/byte[]三种类型方法
compareFaceFeature  | 人脸查找，采用多线程查找，按相似度从高到低返回人脸数组

IRespGrabberService:

接口 | 描述
---|---
startGrabber         | resp流媒体处理，方法为异步，提供重载方法处理一个流及多个流

### 目录结构
```
├─com.nd.arcSoft
│  ├─component                         ------ 初始化
│  ├─config                            ------ 配置类
│  ├─entity                            ------ 模型
│  ├─factory                           ------ 工厂
│  ├─service                           ------ 服务
│  |  ├─impl                           ------ 实现
```
### 引入须知
```
1.本项目可直接打包成jar包引入依赖，仅需在引入项目保障配置正确即可
最少如下：
#虹软
arcsoft:
  appId: 你所申请到的appId
  sdkKey: 你所使用的sdkKey
  libPath: 虹软dll文件目录
  # detectMode设置引擎模式 有 VIDEO 和 IMAGE 两种模式
  # detectFaceOrientPriority 有0 90 128 270 和全角度，默认全角度
  # detectFaceMaxNum 识别最大人脸数，数值越大，越慢，数值越小，越快
  # detectFaceScaleVal 识别的最小人脸比例 = 图片长边 / 人脸框长边的比值
  #                      默认推荐值：VIDEO模式推荐16；IMAGE模式推荐32
  engine:
    detectMode: VIDEO
    detectFaceOrientPriority: ASF_OP_0_ONLY
    detectFaceMaxNum: 8
    detectFaceScale: 16
  # supportAge		      是否支持年龄检测功能
  # supportFace3dAngle	  是否支持3D检测功能
  # supportFaceDetect		  是否支持人脸检测功能
  # supportFaceRecognition  是否支持人脸识别功能
  # supportGender           是否支持性别检测功能
  # supportLiveness		  是否支持RGB活体检测功能
  # supportIRLiveness		  是否支持IR活体检测功能
  function:
    supportAge: false
    supportFace3dAngle: true
    supportFaceDetect: true
    supportFaceRecognition: true
    supportGender: false
    supportLiveness: true
    supportIRLiveness: true
2.libPath需能正常访问
3.sdk分为免费版和离线激活版，免费版第一次激活需保持网络畅通，离线版无此注意事项
4.虹软sdk采用maven安装到本地，命令 mvn install:install-file -Dfile=jar包的位置 -DgroupId=上面的groupId -DartifactId=上面的artifactId -Dversion=上面的version -Dpackaging=jar
```