ArcSoft ArcFace SDK
开发说明文档
©2019 ArcSoft Corporation Limited. All rights reserved.
目录
目录 .................................................................................................................................................. 2
1. 简介........................................................................................................................................... 3
1.1 产品概述 ....................................................................................................................... 3
1.2 环境要求 ....................................................................................................................... 3
1.2.1 运行环境 ........................................................................................................... 3
1.2.2 系统要求 ........................................................................................................... 3
1.2.3 权限申明 ........................................................................................................... 3
1.2.4 支持的颜色空间格式 ....................................................................................... 3
1.3 产品功能简介 ............................................................................................................... 4
1.3.1 人脸检测 ........................................................................................................... 4
1.3.2 人脸跟踪 ........................................................................................................... 4
1.3.3 人脸属性检测 ................................................................................................... 4
1.3.4 人脸三维角度检测 ........................................................................................... 4
1.3.5 人脸比对 ........................................................................................................... 4
1.3.6 活体检测 ........................................................................................................... 5
1.4 SDK 授权说明 ............................................................................................................... 5
2. 接入指南 ................................................................................................................................... 5
2.1 SDK 获取 ....................................................................................................................... 5
2.1.1 注册为开发者 ................................................................................................... 5
2.1.2 SDK 下载 ........................................................................................................... 5
2.1.3 SDK 包结构 ....................................................................................................... 6
2.1.4 工程配置 ........................................................................................................... 6
2.1.5 调用流程 ........................................................................................................... 8
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 ............................................................................................ 11
2.2.7 Class FaceFeature ............................................................................................ 11
2.2.8 Class FaceSimilar ............................................................................................. 11
2.2.9 Class VersionInfo ............................................................................................. 11
2.2.10 Class ErrorInfo ................................................................................................. 11
2.3 错误代码 ..................................................................................................................... 12
2.4 通用方法 ..................................................................................................................... 15
2.4.1 Bitmap 转换成 NV21 数据 ............................................................................. 15
2.4.2 Bitmap 转换成 BGR 数据 ............................................................................... 16
2.5 阈值推荐 ..................................................................................................................... 17
3. 常见问题 ................................................................................................................................. 17
3.1 FAQ .............................................................................................................................. 17
3.2 其他帮助 ..................................................................................................................... 19
1. 简介
1.1 产品概述
ArcFace 离线 SDK,包含人脸检测、性别检测、年龄检测、人脸识别、活体检测等能力,
初次使用时需联网激活,激活后即可本地无网络环境下工作,可根据业务需求结合人脸识别
等 SDK 灵活地进行应用层开发。
1.2 环境要求
1.2.1 运行环境
Android armeabi-v7a
1.2.2 系统要求
支持 Android 4.4 (API Level 19)及以上系统。
1.2.3 权限申明
获取设备唯一标识,用于 SDK 激活授权
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
允许应用联网,用于 SDK 联网激活授权
<uses-permission android:name="android.permission.INTERNET" />
1.2.4 支持的颜色空间格式
NV21, BGR24
常量名
常量值
常量说明
CP_PAF_NV21
2050
8-bit Y 层,之后是 8-bit 的 2x2 采样的 U,V 交织层
CP_PAF_BGR24
513
第一个字节为 R,第二个字节为 G,第三个字节为 B
1.3 产品功能简介
1.3.1 人脸检测
对传入图像数据进行人脸检测,返回人脸位置信息和人脸在图像中的朝向信息,可
用于后续的人脸分析、人脸比对操作,支持图像模式和视频流模式。
支持单人脸、多人脸检测,最多支持检测人脸数为 50。
1.3.2 人脸跟踪
捕捉视频流中的人脸信息,并对人脸进行跟踪。
1.3.3 人脸属性检测
对检测到的人脸进行属性分析,支持性别、年龄的属性分析,支持图像模式和视频
流模式。
1.3.4 人脸三维角度检测
检测输入图像数据指定区域人脸的三维角度信息,包含人脸三个空间角度:俯仰角
(pitch), 横滚角(roll), 偏航角(yaw), 支持图像模式和视频流模式。
1.3.5 人脸比对
将两个人脸进行比对,来判断是否为同一个人,返回比对相似度值。
1.3.6 活体检测
离线活体检测,基于 RGB 单目摄像头实现静默式识别。针对视频流/图片,通过采
集人像的破绽来判断目标对象是否为活体,可有效防止照片、屏幕二次翻拍等作弊攻
击。
1.4 SDK 授权说明
SDK 授权按设备进行授权,每台硬件设备需要一个独立的授权,此授权的校验基于设
备的唯一标识,被授权的设备,初次授权时需要联网进行授权,授权成功后在有效期内可以
离线运行 SDK。
激活一台设备后,遇以下情况,需要重新联网激活:
删除基于 SDK 开发的应用或删除应用数据
刷新安卓系统
激活一台设备后,硬件信息发生变更
2. 接入指南
2.1 SDK 获取
2.1.1 注册为开发者
访问 ArcSoft AI 开放平台门户:https://ai.arcsoft.com.cn,注册开发者账号并登录。
2.1.2 SDK 下载
创建对应的应用,并选择需要下载的 SDK、对应平台即版本,确认后即可下载 SDK
和查看激活码。