colinchang/arcface5 repository overview

⁠ArcFace.Net

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

⁠Nuget

https://www.nuget.org/packages/ArcFace.Net/⁠

⁠版本差异

• 4.x 图像处理基于System.Drawing开发，微软在 .Net 6 及之后版本已不再维护
• 5.x 图像处理基于ImageSharp⁠开发，仅支持.Net 6+

⁠平台支持

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 文件自行编译。

docker build -f Dockerfiles/aspnet-6.0/Dockerfile -t colinchang/arcface5:aspnet-6.0 .
docker build -f Dockerfiles/runtime-6.0/Dockerfile -t colinchang/arcface5:runtime-6.0 .

⁠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⁠