ArcFace.Net.Abstraction 1.0.0

ArcFace.Net

虹软人脸识别.NET(.Net 6)工具库。基于ArcFace 3.x C++ SDK, 支持Windows x86/x64和Linux x64. 支持人脸库属性检测、人脸特征提取、人脸库维护、人脸搜索、活体检测等功能。

项目结构

• ArcFace.Core 人脸识别核心库，需要注入图像处理工具库后才可使用。
• ArcFace.ImageSharp 基于ImageSharp图像处理的人脸识别库。
• ArcFace.SystemDrawing 基于System.Drawing.Common的图像处理的人脸识别库。

版本差异

• 4.x 图像处理基于System.Drawing.Common开发，微软在 .Net 6 及之后版本已不再维护
• 5.x 图像处理基ImageSharp开发，仅支持.Net 6+
• 自定义实现。用户使用任意图像处理库（如 SkiaSharp）实现IImageProcessor接口来自定义版本实现，此时仅需引用ArcFace.Core核心库即可。定制版本实现可以参照 4.x/5.x 版本代码。

平台支持

1. Windows x86/x64

2. Linux x64

   • 该程序基于ArcFace 3.x C++ SDK开发，DllImport引入C++动态库时依赖于Linux系统库(libdl.so.2)，因此低配Linux环境(如alpine等)可能存在兼容性问题。 经测试以下可以正常运行。
     • Debian 10 +
     • Ubuntu20.04 +
     • CentOS 8 +

3. Docker

   我们为本程序库的运行环境打包了Docker镜像，有需要的读者可以点此获取，也可以使用 Dockerfiles 中的不同版本的 Dockerfile 文件自行编译。

# 5.x ImageSharp
docker build -f ColinChang.ArcFace.ImageSharp/Dockerfiles/aspnet-6.0/Dockerfile -t colinchang/arcface5:aspnet-6.0 .
docker build -f ColinChang.ArcFace.ImageSharp/Dockerfiles/runtime-6.0/Dockerfile -t colinchang/arcface5:runtime-6.0 .

# 4.x SystemDrawing
docker build -f ColinChang.ArcFace.SystemDrawing/Dockerfiles/aspnet-6.0/Dockerfile -t colinchang/arcface5:aspnet-6.0 .
docker build -f ColinChang.ArcFace.SystemDrawing/Dockerfiles/runtime-6.0/Dockerfile -t colinchang/arcface5:runtime-6.0 .

Nuget

• ArcFace.Net.Core
• ArcFace.Net

SDK

从 虹软开发者中心或此处下载需要的SDK 3.x文件并放置同特定目录。

• Windows 需要将SDK dll文件拷贝到执行程序所在目录，或环境变量配置的目录
• Linux 需要将SDK so文件拷贝到 /lib 系统程序目录，或环境变量配置的目录

从 虹软开发者中心 获取授权信息(AppId/SdkKey)，通过ArcFaceOptions传入配置。具体用法参见 示例程序。

资源回收

• 工具中自动维护引擎池进行资源回收利用，无需手动管理。
• 工具支持多并发操作。
• 推荐使用单例方式使用。
• ArcFace 实现 IDisposable，使用完毕后需要 Dispose() 以销毁引擎回收其它相关内存。

图像质量要求

• 图片尺寸大于2K且小于10MB
• 图片格式支持 .jpg, .png, .bmp
• 图片中人脸尺寸不小于50 x 50像素
• 建议待检测的图像人脸角度上、下、左、右转向小于30度

人脸3D角度

俯仰角（pitch）， 横滚角（roll）， 偏航角（yaw）

错误码

问题

• 人脸检测和特性提取目前进识别到的人脸角度不准确，目前识别到的角度均为0度。
• 视频模式人脸追踪未开发
• 活体检测未开发

参考文档

https://github.com/colin-chang/ArcFace.Net/blob/main/sdk_3.0.pdf