无标题文档
ArcSoft IdCardVeri SDK Windows平台
开发说明文档 V2.0

1. 简介

1.1 产品概述

人证核验SDK,包含人脸采集、人脸检测、人证核验等能力,主要实现人证的1:1比对。该SDK完全在无网环境下工作, 全部离线化、本地化,所有数据在设备本地运行处理,可 根据业务需要进行灵活的上层业务开发。
该SDK仅限于采集照与二代身份证件比对,不推荐使用于其他应场景。

1.2 环境要求

1.2.1 运行环境

windows 7 及以上

1.2.2 开发环境

vs2013及以上

1.2.3 支持的颜色空间格式

支持图像的颜色空间格式: NV21,NV12, BGR24,I420,YUYV

常量名 常量值 常量说明
ASVL_PAF_NV21 2050 8-bit Y 通道,8-bit 2x2 采样 V 与 U 分量交织通道
ASVL_PAF_NV12 2049 8-bit Y 通道,8-bit 2x2 采样 U 与 V 分量交织通道
ASVL_PAF_BGR24 513 RGB 分量交织,按 B, G, R, B 字节序排布
ASVL_PAF_I420 1537 8-bit Y 通道, 8-bit 2x2 采样 U 通道, 8-bit 2x2 采样 V 通道
ASVL_PAF_YUYV 1289 YUV 分量交织, V 与 U 分量 2x1 采样,按 Y0, U0, Y1, V0 字节序排布

1.3 产品功能简介

1.3.1 人脸特征提取

提取视频帧或者图片中人脸的特征

1.3.2 证件照特征提取

提取证件照中人脸的特征

1.3.3 人证比对

比对视频帧或者图片中人脸特征和证件照中人脸特征,获取相似度

1.4 SDK授权说明

SDK授权按设备进行授权,每台硬件设备需要一个独立的授权,此授权的校验是基于设备的唯一标识,被授权的设备,初次授权时需要联网进行授权,授权成功后在有效期内可以离线运行SDK。
激活一台设备后,遇以下情况,设备授权不变,但需要重新联网激活:

  • 删除基于SDK开发的应用或删除应用数据
  • 重新安装系统
  • 激活一台设备后,硬件信息发生变更

2. 接入指南

2.1 引擎获取

2.1.1 注册为开发者

访问ArcSoft 视觉开放平台门户: https://ai.arcsoft.com.cn,注册开发者账号并登录。

2.1.2 SDK下载

创建对应的应用,并选择需要下载的SDK、对应平台以及版本,确认后即可下载SDK和查看激活码。

image

可在查看激活码链接中获取APPID和SDKKey,点击下载SDK下载SDK包。

image

2.1.3 SDK包结构

|---doc
|    |---ARCSOFT_IDCARD_VERI_DEVELOPER'S_GUIDE.PDF            开发说明文档
|---inc
|    |---amcomdef.h                                        平台文件
|    |---asvloffscreen.h                                    平台文件
|    |--- arcsoft_idcardveri.h                                接口文件
|    |---merror.h                                            错误码文件
|---lib
|    |---x86(x64)
|        |---libarcsoft_face.dll                            算法库
|        |---libarcsoft_face_engine.dll                    算法库
|        |---libarcsoft_idcardveri.dll                        引擎库
|        |---libarcsoft_idcardveri.lib                        引擎库
|---samplecode
|    |---samplecode.cpp                                  示例代码
|---releasenotes.txt                                    说明文件

2.1.4 调用流程
image

Step1:激活SDK

Step2:初始化引擎

Step3:获取视频帧或者图片,设置视频或者图片模式,构建ASVLOFFSCREEN图像信息,提取人脸特征

Step4:获取采集的证件照,构建ASVLOFFSCREEN图像信息,提取证件照人脸特征

Step5:比对人脸特征

Step6:释放引擎

2.1.5 阈值推荐

阈值区间为[0~1],接口ArcSoft_FIC_FaceIdCardCompare建议阈值参数threshold设置为0.82,可根据实际场景需求进行调整。

3. 常见问题

3.1 说明

1.该SDK仅限于采集照与二代身份证证件照比对,不推荐使用于其他应用场景,若有定制升级需求,请联系我们。
2.此SDK需要激活,激活后请不要尝试删除或者修改激活文件idv_install.dat。

3.2 帮助

SDK交流论坛:http://ai.arcsoft.com.cn/bbs/