1# IExecutor 2 3 4## 概述 5 6定义执行器接口，用于获取执行器，获取凭据模版信息，注册人脸特征模版，进行用户人脸认证，删除人脸特征模版等。 7 8**起始版本：** 3.2 9 10**相关模块：**[HdfFaceAuth](_hdf_face_auth_v10.md) 11 12 13## 汇总 14 15 16### Public 成员函数 17 18| 名称 | 描述 | 19| -------- | -------- | 20| [GetExecutorInfo](#getexecutorinfo) ([out] struct [ExecutorInfo](_executor_info_faceauth_v10.md) executorInfo) | 获取执行器信息，人脸认证服务将执行器注册到用户认证框架时需要通过该接口获取对应信息。 | 21| [GetTemplateInfo](#gettemplateinfo) ([in] unsigned long templateId, [out] struct [TemplateInfo](_template_info_faceauth_v10.md) templateInfo) | 获取凭据模版信息。 | 22| [OnRegisterFinish](#onregisterfinish) ([in] unsigned long[] templateIdList, [in] unsigned char[] frameworkPublicKey, [in] unsigned char[] extraInfo) | 完成执行器注册，对人脸特征模版进行对账，用于删除无效的人脸特征模板及相关信息。 | 23| [Enroll](#enroll) ([in] unsigned long scheduleId, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_faceauth_v10.md) callbackObj) | 注册人脸特征模版。 | 24| [Authenticate](#authenticate) ([in] unsigned long scheduleId, [in] unsigned long[] templateIdList, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_faceauth_v10.md) callbackObj) | 人脸认证。 | 25| [Identify](#identify) ([in] unsigned long scheduleId, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_faceauth_v10.md) callbackObj) | 人脸识别。 | 26| [Delete](#delete) ([in] unsigned long[] templateIdList) | 删除人脸特征模版。 | 27| [Cancel](#cancel) ([in] unsigned long scheduleId) | 取消操作请求。 | 28| [SendCommand](#sendcommand) ([in] int commandId, [in] unsigned char[] extraInfo, [in] [IExecutorCallback](interface_i_executor_callback_faceauth_v10.md) callbackObj) | 发送人脸认证功能相关操作命令。 | 29 30 31## 成员函数说明 32 33 34### Authenticate() 35 36``` 37IExecutor::Authenticate ([in] unsigned long scheduleId, [in] unsigned long[] templateIdList, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 38``` 39**描述** 40人脸认证。 41 42**起始版本：** 3.2 43 44**参数:** 45 46| 名称 | 描述 | 47| -------- | -------- | 48| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 49| templateIdList | 指定要认证的模版ID列表。 | 50| extraInfo | 其他相关信息，用于支持信息扩展。 | 51| callbackObj | 回调对象。详细说明请参考[IExecutorCallback](interface_i_executor_callback_faceauth_v10.md)。 | 52 53**返回：** 54 550 表示操作成功。 56 57非0 表示操作失败。 58 59 60### Cancel() 61 62``` 63IExecutor::Cancel ([in] unsigned long scheduleId) 64``` 65**描述** 66取消操作请求。 67 68**起始版本：** 3.2 69 70**参数:** 71 72| 名称 | 描述 | 73| -------- | -------- | 74| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 75 76**返回：** 77 780 表示操作成功。 79 80非0 表示操作失败。 81 82 83### Delete() 84 85``` 86IExecutor::Delete ([in] unsigned long[] templateIdList) 87``` 88**描述** 89删除人脸特征模版。 90 91**起始版本：** 3.2 92 93**参数:** 94 95| 名称 | 描述 | 96| -------- | -------- | 97| templateIdList | 指定要删除的模版ID列表。 | 98 99**返回：** 100 1010 表示操作成功。 102 103非0 表示操作失败。 104 105 106### Enroll() 107 108``` 109IExecutor::Enroll ([in] unsigned long scheduleId, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 110``` 111**描述** 112注册人脸特征模版。 113 114**起始版本：** 3.2 115 116**参数:** 117 118| 名称 | 描述 | 119| -------- | -------- | 120| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 121| extraInfo | 其他相关信息，用于支持信息扩展。 | 122| callbackObj | 回调对象。详细说明请参考[IExecutorCallback](interface_i_executor_callback_faceauth_v10.md)。 | 123 124**返回：** 125 1260 表示操作成功。 127 128非0 表示操作失败。 129 130 131### GetExecutorInfo() 132 133``` 134IExecutor::GetExecutorInfo ([out] struct ExecutorInfo executorInfo) 135``` 136**描述** 137获取执行器信息，人脸认证服务将执行器注册到用户认证框架时需要通过该接口获取对应信息。 138 139**起始版本：** 3.2 140 141**参数:** 142 143| 名称 | 描述 | 144| -------- | -------- | 145| executorInfo | 执行器信息。详细说明请参考[ExecutorInfo](_executor_info_faceauth_v10.md)。 | 146 147**返回：** 148 1490 表示操作成功。 150 151非0 表示操作失败。 152 153 154### GetTemplateInfo() 155 156``` 157IExecutor::GetTemplateInfo ([in] unsigned long templateId, [out] struct TemplateInfo templateInfo ) 158``` 159**描述** 160获取凭据模版信息。 161 162**起始版本：** 3.2 163 164**参数:** 165 166| 名称 | 描述 | 167| -------- | -------- | 168| templateId | 凭据模版ID。 | 169| templateInfo | 凭据模版信息。详细说明请参考[TemplateInfo](_template_info_faceauth_v10.md)。 | 170 171**返回：** 172 1730 表示操作成功。 174 175非0 表示操作失败。 176 177 178### Identify() 179 180``` 181IExecutor::Identify ([in] unsigned long scheduleId, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 182``` 183**描述** 184人脸识别。 185 186**起始版本：** 3.2 187 188**参数:** 189 190| 名称 | 描述 | 191| -------- | -------- | 192| scheduleId | 调度ID，用于标识一次操作请求的调度过程。 | 193| extraInfo | 其他相关信息，用于支持信息扩展。 | 194| callbackObj | 回调对象。详细说明请参考[IExecutorCallback](interface_i_executor_callback_faceauth_v10.md)。 | 195 196**返回：** 197 1980 表示操作成功。 199 200非0 表示操作失败。 201 202 203### OnRegisterFinish() 204 205``` 206IExecutor::OnRegisterFinish ([in] unsigned long[] templateIdList, [in] unsigned char[] frameworkPublicKey, [in] unsigned char[] extraInfo ) 207``` 208**描述** 209完成执行器注册，对人脸特征模版进行对账，用于删除无效的人脸特征模板及相关信息。 210 211**起始版本：** 3.2 212 213**参数:** 214 215| 名称 | 描述 | 216| -------- | -------- | 217| templateIdList | 用户认证框架内由该执行器注册的人脸特征模版ID列表。 | 218| frameworkPublicKey | 用户认证框架的公钥，用于校验用户认证框架私钥签名的信息。 | 219| extraInfo | 其他相关信息，用于支持信息扩展。 | 220 221**返回：** 222 2230 表示操作成功。 224 225非0 表示操作失败。 226 227 228### SendCommand() 229 230``` 231IExecutor::SendCommand ([in] int commandId, [in] unsigned char[] extraInfo, [in] IExecutorCallback callbackObj ) 232``` 233**描述** 234发送人脸认证功能相关操作命令。 235 236**起始版本：** 3.2 237 238**参数:** 239 240| 名称 | 描述 | 241| -------- | -------- | 242| commandId | 操作命令ID。详细说明请参考[CommandId](_hdf_face_auth_v10.md#commandid)。 | 243| extraInfo | 其他相关信息，用于支持信息扩展。 | 244| callbackObj | 回调对象。详细说明请参考[IExecutorCallback](interface_i_executor_callback_faceauth_v10.md)。 | 245 246**返回：** 247 2480 表示操作成功。 249 250非0 表示操作失败。 251