ArcSoft ArcFace SDK
开发说明文档
© 2019 ArcSoft Corporation Limited. All rights reserved.
版本历史
SDK 版本
日期
作者
描述
2.2
06/14/2019
ArcSoft
优化算法库，新增 IR 活体检测、活体检测阈值设置
接口。适用于 Win32: 2.2.3900020101.1;
Win64: 2.2.3902020101.1; Linux64: 2.2.12402020101.1
目录
目录................................................................................................................................................... 3
1. 简介........................................................................................................................................... 4
1.1 产品概述 ........................................................................................................................... 4
1.2 环境要求 ........................................................................................................................... 4
1.2.1 运行环境 ............................................................................................................... 4
1.2.2 支持的颜色空间格式 ........................................................................................... 5
1.3 产品功能简介 ............................................................................................................... 5
1.3.1 人脸检测 ............................................................................................................... 5
1.3.2 人脸跟踪 ............................................................................................................... 5
1.3.3 人脸属性检测 ....................................................................................................... 5
1.3.4 人脸三维角度检测 ............................................................................................... 5
1.3.5 人脸特征提取 ....................................................................................................... 6
1.3.6 人脸比对 ............................................................................................................... 6
1.3.7 活体检测 ............................................................................................................... 6
1.4 SDK 授权说明 ............................................................................................................... 6
2. SDK 接入指南 ........................................................................................................................... 7
2.1 获取 SDK ....................................................................................................................... 7
2.1.1 注册开发者账号 ................................................................................................... 7
2.1.2 SDK 下载 ............................................................................................................... 7
2.1.3 SDK 包结构 ........................................................................................................... 8
2.1.4 工程配置 ............................................................................................................... 9
2.1.5 调用流程 ............................................................................................................... 9
2.2 核心类介绍 ................................................................................................................. 10
2.2.1 Class FaceEngine .................................................................................................. 10
2.2.2 Class FaceInfo ....................................................................................................... 10
2.2.3 Class AgeInfo......................................................................................................... 10
2.2.4 Class GenderInfo ................................................................................................... 10
2.2.5 Class Face3DAngle ................................................................................................ 10
2.2.6 Class LivenessInfo ................................................................................................. 10
2.2.7 Class IrLivenessInfo ............................................................................................... 11
2.2.8 Class FaceFeature ................................................................................................. 11
2.2.9 Class FaceSimilar .................................................................................................. 11
2.2.10 Class VersionInfo ................................................................................................... 11
2.2.11 Class ErrorInfo ....................................................................................................... 11
2.3 错误码列表 ..................................................................................................................... 12
2.4 阈值推荐 ......................................................................................................................... 15
3. 常见问题................................................................................................................................. 16
3.1 FAQ .................................................................................................................................. 16
3.2 其他帮助 ......................................................................................................................... 17
1. 简介
1.1 产品概述
ArcFace 离线 SDK，包含人脸检测、性别检测、年龄检测、人脸识别、RGB 活体检测、
IR 活体检测等能力，初次使用时需联网激活，激活后即可在本地无网络环境下工作，可根
据具体的业务需求结合人脸识别 SDK 灵活地进行应用层开发。
1.2 环境要求
1.2.1 运行环境
Windows 7、CentOS7, Ubuntu14.04 以上的操作系统
JDK 8 或以上版本（注意区分 32 位和 64 位与算法库保持一致）
Windows 平台需安装 vcredist2013（注意区分 32 位和 64 位与算法库保持一致）
Linux 平台需安装 glibc 2.17 库依赖及以上
1.2.2 支持的颜色空间格式
常量名
常量值
颜色格式说明
CP_PAF_NV21
2050
8-bit Y 通道，8-bit 2x2 采样 V 与 U 分量交织通道
CP_PAF_NV12
2049
8-bit Y 通道，8-bit 2x2 采样 U 与 V 分量交织通道
CP_PAF_RGB24
513
RGB 分量交织，按 B, G, R, B 字节序排布
CP_PAF_I420
1537
8-bit Y 通道， 8-bit 2x2 采样 U 通道， 8-bit 2x2 采
样 V 通道
CP_PAF_YUYV
1289
YUV 分量交织， V 与 U 分量 2x1 采样，按 Y0, U0, Y1,
V0 字节序排布
CP_PAF_GRAY
1793
8-bit IR 图像
CP_PAF_DEPTH_U16
3074
16-bit IR 图像
1.3 产品功能简介
1.3.1 人脸检测
对传入的图像数据进行人脸检测，返回人脸的边框以及朝向信息，可用于后续的人脸识
别、活体检测等操作；
支持 image 模式和 video 模式；
支持单人脸、多人脸检测，最多支持检测人脸检测数为 50。
1.3.2 人脸跟踪
对来自于视频流中的图像数据，进行人脸检测，并对检测到的人脸进行持续跟踪。
1.3.3 人脸属性检测
人脸属性分析，支持性别、年龄等。
1.3.4 人脸三维角度检测
分析人脸的三维角度信息，具体为：俯仰角（pitch）， 横滚角（roll）， 偏航角（yaw）。
评论0