1# HdfFaceAuth 2 3 4## **概述** 5 6提供人脸认证驱动的标准API接口。 7 8人脸认证驱动为人脸认证服务提供统一的访问接口。获取人脸认证驱动代理后，人脸认证服务可以调用相关接口获取执行器，获取人脸认证执行器后， 人脸认证服务可以调用相关接口获取执行器，获取凭据模版信息，注册人脸特征模版，进行用户人脸认证，删除人脸特征模版等。 9 10**Since：** 11 123.2 13 14 15## **汇总** 16 17 18### 文件 19 20 | 名称 | 描述 | 21| -------- | -------- | 22| [FaceAuthTypes.idl](_face_auth_types_8idl.md) | 定义人脸认证驱动的枚举类和数据结构。 | 23| [IExecutor.idl](face__auth_2_i_executor_8idl.md) | 定义执行器接口，用于获取执行器，获取凭据模版信息，注册人脸特征模版，进行用户人脸认证，删除人脸特征模版等。 | 24| [IExecutorCallback.idl](face__auth_2_i_executor_callback_8idl.md) | 定义异步API接口回调，用于返回异步接口的请求处理结果和信息。 | 25| [IFaceAuthInterface.idl](_i_face_auth_interface_8idl.md) | 定义获取人脸认证驱动的执行器列表接口，用于从人脸认证驱动获取执行器对象列表。 | 26 27 28### 类 29 30 | 名称 | 描述 | 31| -------- | -------- | 32| [ExecutorInfo](_executor_info.md) | 执行器信息。 | 33| [TemplateInfo](_template_info.md) | 凭据模版信息。 | 34| [IExecutor](interface_i_executor.md) | 定义执行器接口，用于获取执行器，获取凭据模版信息，注册人脸特征模版，进行用户人脸认证，删除人脸特征模版等。 | 35| [IExecutorCallback](interface_i_executor_callback.md) | 定义异步API接口回调，用于返回异步接口的请求处理结果和信息。使用细节见[IExecutor](interface_i_executor.md)。 | 36| [IFaceAuthInterface](interface_i_face_auth_interface.md) | 定义获取人脸认证驱动的执行器列表接口。 | 37 38 39### 枚举 40 41 | 名称 | 描述 | 42| -------- | -------- | 43| [AuthType](#authtype): int { PIN = 1, FACE = 2, FINGERPRINT = 4 } | 枚举用户认证凭据类型。 | 44| [ExecutorRole](#executorrole): int { COLLECTOR = 1, VERIFIER = 2, ALL_IN_ONE = 3 } | 枚举执行器角色。 | 45| [ExecutorSecureLevel](#executorsecurelevel): int { ESL0 = 0, ESL1 = 1, ESL2 = 2, ESL3 = 3 } | 枚举执行器安全等级。 | 46| [CommandId](#commandid): int { LOCK_TEMPLATE = 1, UNLOCK_TEMPLATE = 2, VENDOR_COMMAND_BEGIN = 10000 } | 枚举人脸认证功能相关操作命令。 | 47| [FaceTipsCode](#facetipscode): int { FACE_AUTH_TIP_TOO_BRIGHT = 1, FACE_AUTH_TIP_TOO_DARK = 2, FACE_AUTH_TIP_TOO_CLOSE = 3, FACE_AUTH_TIP_TOO_FAR = 4, FACE_AUTH_TIP_TOO_HIGH = 5, FACE_AUTH_TIP_TOO_LOW = 6, FACE_AUTH_TIP_TOO_RIGHT = 7, FACE_AUTH_TIP_TOO_LEFT = 8, FACE_AUTH_TIP_TOO_MUCH_MOTION = 9, FACE_AUTH_TIP_POOR_GAZE = 10, FACE_AUTH_TIP_NOT_DETECTED = 11, VENDOR_FACE_AUTH_TIP_BEGIN = 10000 } | 枚举提示信息编码。 | 48 49 50### 关键字 51 52 | 名称 | 描述 | 53| -------- | -------- | 54| package ohos.hdi.face_auth.v1_0 | 人脸认证接口的包路径 | 55 56 57## **枚举类型说明** 58 59 60### AuthType 61 62 63``` 64enum AuthType : int 65``` 66 67**描述：** 68 69枚举用户认证凭据类型。 70 71 | 枚举值 | 描述 | 72| -------- | -------- | 73| PIN | 认证凭据类型为口令。 | 74| FACE | 认证凭据类型为人脸。 | 75| FINGERPRINT | 认证凭据类型为指纹。 | 76 77 78### CommandId 79 80 81``` 82enum CommandId : int 83``` 84 85**描述：** 86 87枚举人脸认证功能相关操作命令。 88 89 | 枚举值 | 描述 | 90| -------- | -------- | 91| LOCK_TEMPLATE | 锁定人脸模版。 | 92| UNLOCK_TEMPLATE | 解锁人脸模版。 | 93| VENDOR_COMMAND_BEGIN | 用于厂商自定义操作指令。 | 94 95 96### ExecutorRole 97 98 99``` 100enum ExecutorRole : int 101``` 102 103**描述：** 104 105枚举执行器角色。 106 107 | 枚举值 | 描述 | 108| -------- | -------- | 109| COLLECTOR | 执行器角色为采集器，提供用户认证时的数据采集能力，需要和认证器配合完成用户认证。 | 110| VERIFIER | 执行器角色为认证器，提供用户认证时数据处理能力，读取存储凭据模板信息并完成比对。 | 111| ALL_IN_ONE | 执行器角色为全功能执行器，可提供用户认证数据采集、处理、储存及比对能力。 | 112 113 114### ExecutorSecureLevel 115 116 117``` 118enum ExecutorSecureLevel : int 119``` 120 121**描述：** 122 123枚举执行器安全等级。 124 125 | 枚举值 | 描述 | 126| -------- | -------- | 127| ESL0 | 执行器安全级别为0，关键操作在无访问控制执行环境中完成。 | 128| ESL1 | 执行器安全级别为1，关键操作在有访问控制的执行环境中完成。 | 129| ESL2 | 执行器安全级别为2，关键操作在可信执行环境中完成。 | 130| ESL3 | 执行器安全级别为3，关键操作在高安环境如独立安全芯片中完成。 | 131 132 133### FaceTipsCode 134 135 136``` 137enum FaceTipsCode : int 138``` 139 140**描述：** 141 142枚举提示信息编码。 143 144 | 枚举值 | 描述 | 145| -------- | -------- | 146| FACE_AUTH_TIP_TOO_BRIGHT | 获取的人脸图像由于光照度高而过亮。 | 147| FACE_AUTH_TIP_TOO_DARK | 获取的人脸图像由于光照度低而过暗。 | 148| FACE_AUTH_TIP_TOO_CLOSE | 人脸离设备过近。 | 149| FACE_AUTH_TIP_TOO_FAR | 人脸离设备过远。 | 150| FACE_AUTH_TIP_TOO_HIGH | 设备过高，只拍到人脸的上半部分。 | 151| FACE_AUTH_TIP_TOO_LOW | 设备过低，只拍到人脸的下半部分。 | 152| FACE_AUTH_TIP_TOO_RIGHT | 设备偏右，只拍到人脸的右侧部分。 | 153| FACE_AUTH_TIP_TOO_LEFT | 设备偏左，只拍到人脸的左侧部分。 | 154| FACE_AUTH_TIP_TOO_MUCH_MOTION | 人脸信息采集过程中，人脸移动过多。 | 155| FACE_AUTH_TIP_POOR_GAZE | 用户未注视设备。 | 156| FACE_AUTH_TIP_NOT_DETECTED | 未检测到人脸。 | 157| VENDOR_FACE_AUTH_TIP_BEGIN | 用于厂商自定义提示信息。 | 158