说明:
1. 通过get biz token接口获取token
2. 下载SDK,集成到客户的APP
android SDK下载:assets.faceid/faceidopen/sdk/FaceIDZFAC_1.2.0A.zip
iOS SDK下载:assets.faceid/faceidopen/sdk/FaceIDZFAC_1.2.0I.zip
1. (可选) 通过get_result接口获取详情
下面进行详细阐述
第1步:使用get_biz_token获取biz_token
调用地址
POST fid.market.alicloudapi/face/v2/sdk/get_biz_token
签名方式
参见阿里云文档:
help.aliyun/document_detail/29490.html?spm=5176.t.10.O4CB1x
参数
选/
参数类型参数说明
liveness_type string刷脸验证流程中的活体类型,当前只支持meglive(动作活体);必
idcard_name string姓名
idcard_number string身份证号
image_ref1string由客户提供的参照人脸照片
image_ref2string由客户提供的参照人脸照片
可选biz_no string
客户业务流水号,建议设置为您的业务相关的流水串号并且唯一。并会在
return 时原封不动的返回给您的服务器,以帮助您确认对应业务的归属。此
字段不超过128字节
可选liveness_timeout int
超时时间,默认值为 60,表示用户进入活体识别流程后的超时时间,若未
在规定时间完成操作,则本次活体失败
api接口和sdk接口的区别liveness_action_count int动作活体时动作个数:默认3个动作;默认 3,∈ [1,3]
可选security_level int
表示对比对结果的严格程度限制,请根据您的场景,选择安全规则,越严
格,准确性要求越高,通过率也会相应下降
1:宽松(误识率为千分之一);
2:标准(误识率为万分之一,默认值);
3:严格(误识率为十万分之一);
4:非常严格(误识率为百万分之一);
可选force_compare int
表示云端判断为假脸后,是否依然进行比对;
0:默认值,云端判断为假脸,则直接返回结果,不执行比对,可以节省成
本;
1:云端判断为假脸后,依然进行比对
可选multi_oriented_detection int
对于image_ref1,image_ref2 参考照片,当检测不出人脸时,是否旋转90
度、180度、270度后再检测人脸。
"1": 默认值,要旋转检测;
“0”:不旋转;
请注意:设置此参数为1可能会轻微增加误检人脸的概率,如果您明确您的
业务场景里不存在非正向的人脸图片、或概率极低,建议勿设置此参数。
返回值
参数类型参数说明
request_id string用于区分每一次请求的唯一的字符串。此字符串可以用于后续数据反查。此字段必定返回。time_used int整个请求所花费的时间,单位为毫秒。此字段必定返回。
biz_token string调用 SDK 时传入的信息。请求成功时返回。
error string具体返回内容见错误码列表。请求失败时返回。
错误码列表
HTTP
状态
错误信息说明
400MISSING_ARGUMENTS:<key>缺少某个必选参数。
400BAD_ARGUMENTS:<key>某个参数解析出错(比如必须是数字,但是输入的是非数字字符串; 或者长度过长)
400IMAGE_ERROR_UNSUPPORTED_FORMAT:
<param>
参数<param>对应的图像无法解析,有可能不是图像文件、或
有数据破损。<param>为 image_ref1、 image_ref2中的一个。
请注意:<param>只会有一项,即第一个满足条件的名称。
400NO_FACE_FOUND:<param>表示上传的 image ref 的图像中,没有检测到人脸。param为image ref1、 image_ref2中的一个。请注意:<param>只会有一项,即第一个满足条件的名称。
400INVALID_IMAGE_SIZE<param>客户上传的图像太大,具体是指像素尺寸的长或宽超过4096像素。<param>为 image_ref1、 image_ref2中的一个。请注意:<param>只会有一项,即第一个满足条件的名称。
403AUTHENTICATION_ERROR无效签名
403AUTHORIZATION_ERROR:<reason>调用次数超限、没有调用此API的权限,或者没有以当前方式调用此API的权限
403CONCURRENCY_LIMIT_EXCEEDED并发数超过限制404API_NOT_FOUND所调用的API不存在
413Request Entity Too Large 客户发送的请求大小超过了20MB限制。该错误的返回格式为纯文本,不是json格式。
500INTERNAL_ERROR 服务器内部错误,当此类错误发生时请再次请求,如果持续出现此类错误,请及时联系 FaceID 客服或商务
第2步:集成SDK
2.1 Android SDK说明
入口类
public static synchronized FaceIdManager getInstance(Context context);
参数说明
参数说明
Context android.os.Context:建议使用ApplicationContext
返回值说明
返回值说明
FaceIdManager入口类FaceIdManager的单实例对象
初始化接口
public void init( String bizToken);
调用说明
必须在调用所有接口前,初始化成功,否则无法正常工作。
参数说明
参数说明
bizToken业务流水号
开始检测接口
public void startDetect();
参数说明
参数说明
无无
返回值说明
返回值说明
void无返回值
设置Init回调接口
public void setFaceIdInitListener(FaceIdInitListener listener);

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。