说明：
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);