C# 超简单的离线人脸识别库( 基于 SeetaFace6 )+源代码+文档说明

<div align="center"> # ViewFaceCore [](https://www.nuget.org/packages/ViewFaceCore/) &nbsp;&nbsp; [](https://github.com/ViewFaceCore/ViewFaceCore/blob/main/LICENSE) &nbsp;&nbsp;  &nbsp;&nbsp;  <br/> —— [💎 关于](#1-关于) &nbsp;| [⭐ 快速开始](#2-快速开始) &nbsp;| [📄 基本说明](#4-基本说明) &nbsp;| [🐟 API](#5-viewfacecore-api) &nbsp;| [🔎 参考文档](#6-参考文档) &nbsp;| [❓ 常见问题](#7-常见问题) &nbsp;| [📦 使用许可](#8-使用许可) —— </div> ## 1. 关于 - 一个基于 [SeetaFace6](https://github.com/SeetaFace6Open/index) 的 .NET 人脸识别解决方案 - 本项目受到了 [SeetaFaceEngine.Net](https://github.com/iarray/SeetaFaceEngine.Net) 的启发 - 开源、免费、跨平台 (win/linux) ## 2. 快速开始 ### 2.1 受支持的 .NET 框架 和 操作系统 | 目标框架 |最低版本 | 操作系统 | | :-: |:-: | :-: | | .NET Framework |4.0 | win ( x64/x86 ) | | .NET Standard |2.0 | win ( x64/x86 ) | | .NET / .NET Core |3.1、5.0、6.0、7.0 | win ( x64/x86 )、linux ( arm/arm64/x64 ) | ### 2.2 简单的人脸信息检测 以 Windows x64平台 为例，一个简单的人脸检测Demo。 1. 使用 [nuget](https://www.nuget.org) 安装依赖 | 包名称 | 最小版本 | 生成文件夹 | 说明 | | :- | :-: | - | - | | [ViewFaceCore](https://www.nuget.org/packages/ViewFaceCore/) | [](https://www.nuget.org/packages/ViewFaceCore) | —— | ViewFaceCore .NET 核心库 | | [ViewFaceCore.all_models](https://www.nuget.org/packages/ViewFaceCore.all_models) | [](https://www.nuget.org/packages/ViewFaceCore.all_models) | `viewfacecore\models` | 人脸检测的模型支持(图省事可以直接安装这个) | | [ViewFaceCore.runtime.win.x64](https://www.nuget.org/packages/ViewFaceCore.runtime.win.x64) | [](https://www.nuget.org/packages/ViewFaceCore.runtime.win.x64) | `viewfacecore\win\x64` | Windows-x64 的本机运行时，其它平台自行选择安装，可安装多个 | | [ViewFaceCore.Extension.SkiaSharp](https://www.nuget.org/packages/ViewFaceCore.Extension.SkiaSharp) | <span style="display:inline-block;width:150px"> [](https://www.nuget.org/packages/ViewFaceCore.Extension.SkiaSharp) </span> |  —— | SkiaSharp图像处理扩展，ImageSharp、SkiaSharp、System.Drawing三选一 | 2. 获取人脸信息 ```csharp using SkiaSharp; using System; using ViewFaceCore.Core; using ViewFaceCore.Model; namespace ViewFaceCore.Demo.ConsoleApp { internal class Program { private readonly static string imagePath = @"images/Jay_3.jpg"; static void Main(string[] args) { using var bitmap = SKBitmap.Decode(imagePath); using FaceDetector faceDetector = new FaceDetector(); FaceInfo[] infos = faceDetector.Detect(bitmap); Console.WriteLine($"识别到的人脸数量：{infos.Length} 个人脸信息：\n"); Console.WriteLine($"No.\t人脸置信度\t位置信息"); for (int i = 0; i < infos.Length; i++) { Console.WriteLine($"{i}\t{infos[i].Score:f8}\t{infos[i].Location}"); } Console.ReadKey(); } } } ``` 更多案例可以下载源码查看Demo。 ## 3. 二次开发 ### 3.1 项目结构 ```shell ├─Bridges #Bridges │ ├─Linux ##Linux平台ViewFaceBridge项目 │ ├─Shared ##共享库 │ └─Windows ##Linux平台ViewFaceBridge项目 ├─Examples #一些案例 │ ├─ViewFaceCore.Demo.ConsoleApp ##控制台项目案例 │ ├─ViewFaceCore.Demo.VideoForm ##Winform摄像头人脸识别项目 │ └─ViewFaceCore.Demo.WebApp ##ASP.NET Core web项目 ├─Extensions #扩展包项目 │ ├─ViewFaceCore.Extension.DependencyInjection ##依赖注入扩展 │ ├─ViewFaceCore.Extension.ImageSharp ##ImageSharp图像处理扩展项目 │ ├─ViewFaceCore.Extension.Shared ##共享项目 │ ├─ViewFaceCore.Extension.SkiaSharp ##SkiaSharp图像处理扩展项目 │ └─ViewFaceCore.Extension.SystemDrawing ##System.Drawing图像处理扩展项目 ├─Models #模型项目 ├─Runtimes #对应各个平台的运行时 ├─SeetaFace │ └─index #SeetaFace源码，build文件夹需要放到这个目录下面 ├─Tests #测试项目，包含各种单元测试 └─ViewFaceCore #ViewFaceCore源码 ``` ### 3.2 开发环境 - Visual Studio 2022，需要安装.NET4/4.5支持（[如何在Visual Studio 2022中安装.NET4/4.5？](https://www.quarkbook.com/?p=1311 "如何在Visual Studio 2022中安装.NET4/4.5？")） - Windows 10/11 - Ubuntu 20.04 (WSL)、Debian 10/11等 ### 3.3 编译SeetaFace6 #### 3.3.1 我对编译SeetaFace6不感兴趣~~~ 即中科视图开源的SeetaFace6人脸识别引擎，如果你对编译这块不感兴趣，可以直接下载下面编译好的链接库，放入src/SeetaFace/index目录下面。 二进制文件地址：https://github.com/ViewFaceCore/SeetaFace6OpenBinary/releases 放置好之后的目录结构应该是这样的： ```shell src └─SeetaFace └─index └─build ├─bin │ ├─x64 │ └─x86 ├─cmake ├─include ├─lib │ ├─arm │ ├─arm64 │ ├─x64 │ └─x86 └─lib64 ``` #### 3.3.2 我要编译SeetaFace6 1. SeetaFace6官方编译方式 参考：https://github.com/SeetaFace6Open/index#%E7%BC%96%E8%AF%91%E4%BE%9D%E8%B5%96 2. 使用项目中的编译脚本 参考：https://github.com/ViewFaceCore/ViewFaceCore/blob/main/docs/SeetaFace_Build.md ### 3.4 编译SeetaFaceBridge #### 3.4.1 编译Windows环境下的SeetaFaceBridge 通过3.3.1或者3.3.2小节，完成SeetaFace6编译之后，就可以在VS中直接右键->构建SeetaFaceBridge了。 #### 3.4.2 编译Linux环境下的SeetaFaceBridge 前提条件也是需要通过3.3.1或者3.3.2小节，完成SeetaFace6的编译。 有三种方式可以编译Linux环境下的SeetaFaceBridge，WSL、Remote Linux、交叉编译。具体步奏就不一一介绍了，选择自己比较熟悉或者喜欢的方式，building~ ### 3.5 编译ViewFaceCore 就像编译C#的Hello World一样简单。 ## 4. 基本说明 ### 4.1 各平台Runtime 为了兼容各个平台，我们分别编号好了各个平台的SeetaFace6以及ViewFaceBridge（用于通过C#调用C++写的SeetaFace6）。并打包好，发布到nuget上面。使用时，按需安装对应平台的nuget包。比如windows x64平台，安装对应的nuget包`ViewFaceCore.runtime.win.x64`。runtime可以同时安装多个平台，但是不能不安装，至少需要安装一个当前平台对应的runtime。 支持的平台以及nuget包如下表所示： | Nuget包名 | 版本 | 输出目录 | 说明 | | ------------ | ------------ |------------ | ------------ | | ViewFaceCore.runtime.win.x