无标题文档

常见问题

注册下载
Q:如何注册下载虹软SDK?
A:请参考帮助与支持——新手指南。
Q:虹软SDK包含哪些平台及语言?
虹软视觉开放平台根据不同操作平台提供不同的SDK。目前 SDK(内置活体检测) x86,x64平台(c++/Java语言)、Linux x64平台(c++/Java语言)、iOS平台(Objective-C语言)与Android arm32平台(Java语言); 人证核验SDK 可下载 Windows x86,x64平台(c++语言)与Android arm32平台(Java语言)。请根据操作系统选择下载对应平台的SDK。
Q:如何下载活体检测SDK?
ArcFace2.0及以上版本的SDK已经内置了活体检测,直接下载SDK即可。
注:iOS平台暂未加入活体检测。
Q:如何下载demo参考?
官方针对各版本的SDK提供了对应的Demo,并且下载的SDK包里面有示例代码可以参考。可通过开发者中心首页demo下载链接直接下载, https://ai.arcsoft.com.cn/ucenter/resource/build/index.html#/demoList
引擎说明
Q:SDK支持哪些功能?
A: 支持人脸检测、人脸追踪、人脸比对、年龄检测、性别检测、活体检测、人脸三维角度检测等功能,可以直接下载开发,实现自己的应用场景。
Q:SDK算法是否是开源的?
A: 算法是非开源的,目前免费开放的SDK是封装好的SDK包。
Q:SDK算法是基于CPU还是GPU?
A: 虹软提供的SDK都是基于CPU的,暂无基于GPU的。
Q:调用次数是否有限制?
A:SDK本身是离线的,故对调用次数没有任何限制。
Q:SDK对摄像头有什么具体要求?
A:对摄像头并未设置限制,一般市场上主流的摄像头均可使用。
Q:官方推荐的阈值是多少?
A:阈值的设定需要根据不同应用场景进行不断调整。目前Arcface 2.X版本SDK推荐阈值为0.8左右,具体需根据实际场景的需求及其表现不断调整,以找到最合适的值。
Q:人脸检测和人脸跟踪的接口具体有什么不同呢?
A:人脸检测/图片image模式主要用于静态图片,处理单张图像数据;而人脸跟踪/视频流video模式则主要实现动态视频流检测跟踪,处理连续帧的图像数据。
Q:Arcface 2.2版本开放底层算法faceID指的是什么?
A:FaceID其实是SDK内部自动赋予的值,可以理解为一个人脸从第一次进入视频画面开始识别到最后离开,识别框就一直跟随移动,且这个过程中faceID是不变的。借助faceID的功能,在此人的人脸特征提取成功后,可不再对此人的后续人脸信息进行处理,也就是说FaceID只需检测一次就好,提高了性能。
Q:Arcface 2.SDK对图片的人脸大小有没有要求?
A:SDK对图片人脸占整张图片的比例有一定的要求,具体能检测出的人脸大小可参考开发说明文档中的Scale(人脸尺寸)参数,为了保证算法表现,请在符合所设置的各参数值的情况下,选择尽量清晰的图片。
Q:Arcface 2.SDK对图片尺寸有什么要求?
A:SDK对图像尺寸做了限制,宽高需大于0,宽度为4的倍数,YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24格式的图片高度不限制;请确保传入的图片尺寸符合要求,若不符合可对图片进行适当的裁剪。

网络环境
Q:SDK支持哪些网络?调用需要联网吗
A:虹软提供的SDK本身是离线的,支持离线或在线运行,可实现局域网、互联网等多种网络需求,并可根据场景需求,将应用部署在公有云上,或者搭建私有云,保障数据隐私性以及安全性。
注:V2.0及以上版本SDK首次使用需联网激活,激活后即可在离线环境使用。
收费说明
Q:是免费的吗?
A:是免费的,可以免费下载使用和更新升级,可放心使用。
Q:是否有使用限制?
A:Windows和Linux平台所有的SDK以及Android平台的活体检测有一年期限,自下载之日起,一年内需重新申请下载更新引擎,更新后即可继续免费使用。
Q:是否支持正式商用?商用是不是需要跟虹软签订授权书?
A:支持商用,且不需要签订授权书,根据《虹软(ArcSoft)视觉开放平台服务协议》中的说明,使用者需尊重虹软的知识产权,故应在产品的显著位置正确且完整地标注“Facial Technology by ArcSoft®”或“人脸识别技术由虹软®提供”的字样即可。
Q:一年到期如何更新引擎?
A:更新方式:登录视觉开放平台重新申请下载引擎,将原应用工程中的引擎相关包文件,代码中所使用的APPID以及各引擎Key均替换成最新的即可。
人脸库
Q:”人脸集合1000范围内达到最优”具体是什么意思? SDK支持多大的人脸库?
A: 人脸识别SDK并未对人数做限制,为保障引擎的流畅使用,达到最优的使用体验,虹软推荐设置大小为1000范围内的人脸库。大于1000人可根据实际场景需求进行效果自测。
Q:各平台的特征码是否通用?
A: 通过相同版本人脸比对功能提取的人脸特征在Android、Windows、Linux、iOS平台上均可通用。
Q:提取特征后返回的特征长度是多少??
A:2.0及以上版本SDK提取到的特征数据长度为1032字节,这个值的大小是固定的,单位是B。
Q:人脸库是什么?如何建人脸库?
A:通过特征提取函数提取人脸特征后,将特征码保存到数据库或者文件中,便形成了人脸特征库。
Q:是否包含人脸特征库?
A: SDK只做功能处理,人脸特征库需要自行搭建并管理。
Q:人脸特征怎么保存到数据库?
A:特征码是一个二进制字段,一般数据库提供一个二进制字段来存储二进制数据,比如SQL Server中的BINARY,VERBINARY;MYSQL用Blob;Oracle用blob或者bfile。
Q:人脸库存放位置是否有限制?
A:没有限制, SDK支持离线使用,可根据自身的需求进行人脸库的存储,如产品是单机版本,那么可以将人脸库存在本地;如产品是服务器版本,可把人脸库存放在自己的服务器上。
技术问题
Q:人脸框可以自定义设置大小吗?人脸框还可以往外延伸吗?
A:参数rect返回人脸坐标,如果想更改人脸框大小,可以在rect的基础上自己重新画框,demo是默认将rect坐标连起来成为人脸框的。
Q:SDK是否支持批量注册人脸图片?
A:Arcface2.0及以上版本提供的demo里面实现了批量注册人脸的方法,供参考。
Q:SDK是否支持多线程调用?
A:支持多线程使用,但每个线程都需要进行初始化操作。
Q:错误码90113?
A:一般是权限没有开放,请检查下权限里面有没有加read phone state。
Q:错误码90115?
A:表示SDK未激活,首次使用需先联网激活SDK。
Q:错误码28676?
A:这个错误是说明SDKKey不是当前引擎支持的,请检查key是否填写错误或者引擎包与key是否有一一对应。
Q:错误码90139?
A:2.2版本的全角度检测只支持video模式,image模式下不支持全角度初始化。如果在image模式设置了全角度检测就会报这个错。
Q:错误码90121?
A:SDK的活体功能的有效期为下载日起一年,不在这个时间段内都会报活体已过期的错误,一般有2种情况会导致这个问题:-SDK真的用了一年了;-设备日期变更,需检查设备系统时间。
Q:错误码90127?
A:ArcFace SDK对图像尺寸做了限制,宽度为4的倍数,YUYV/I420/NV21/NV12格式的图片高度为2的倍数,BGR24/GRAY/U16格式的图片高度不限制;如果遇到90127请检查传入的图片尺寸是否符合要求,若不符合可对图片进行适当的裁剪。
Q:错误码81925?
A:图片模糊或者画面中根本没有人脸或者传入的人脸框不正确,需要存下图查看图像模糊度或查看是否修改了FaceInfo中Rect的内容。若是使用双目摄像头,则很有可能是两者成像差距很大或两者画面成镜像或旋转的关系。
Q:错误码86018?
A:86018即需要检测的属性未初始化,需要查看调用接口的属性值有没有在初始化引擎时在combinedMask参数中加入。(比如初始化了年龄检测、性别检测功能,但是process时添加了活体检测的mask)。