收集结果
要获取包含 SDK 采集结果的 FaceReconResponse 对象(包括在 QI Tech 系统中发送的图片标识符),请在启动 FaceReconActivity 的同一 activity 中覆盖 onActivityResult 方法:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE) {
if (resultCode == RESULT_OK && data != null) {
faceReconResponse = data.getParcelableExtra("FaceReconResponse");
image_key = faceReconResponse.image_key;
device_scan_session_id = faceReconResponse.device_scan_session_id;
Log.i(TAG_LIVENESS, "FACE RECON RESPONSE: " + faceReconResponse.image_key);
}
else if (resultCode == RESULT_CANCELED && data != null) {
faceReconResponse = data.getParcelableExtra("FaceReconResponse");
Log.i(TAG_LIVENESS, "FACE RECON RESPONSE: " + faceReconResponse.status_code + " - " + faceReconResponse.reason + " - " + faceReconResponse.description);
}
}
}
FaceReconResponse 对象属性说明
注意:
与 Device Scan 集成 从版本 5.2.0 起,Face Recognition 服务会自动内部调用 Device Scan。因此,成功返回值将包含 device_scan_session_id 字段。此密钥标识内部执行的设备扫描会话,可在 QI Tech 生态系统的其他服务中集成使用。
| 属性 | 描述 | 结果 | 版本 |
|---|---|---|---|
| image_key | 提供的图片标识密钥,可用于 QI Tech 系统的任何其他服务。 | RESULT_OK | 所有版本 |
| device_scan_session_id | 内部执行的设备扫描会话标识密钥,可用于 QI Tech 系统的任何其他服务。 | RESULT_OK | 5.2.0+ |
| status_code | 请求的状态码。 | RESULT_CANCELED | 5.0.0+ |
| reason | 错误标识符 | RESULT_CANCELED | 5.0.0+ |
| description | 错误描述。 | RESULT_CANCELED | 5.0.0+ |
错误结构(SDK 5.0.0+)
重要提示!
从版本 5.0.0 起,错误结构已重构以提供更详细的诊断信息。
示例:InvalidToken
{
status_code = 401
reason = "INVALID_TOKEN"
description = "Authentication token expired or invalid"
}
示例:UserCanceled
{
status_code = 0
reason = "USER_CANCELED"
description = "User pressed the back button."
}
旧版本
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
FaceRecognition.RequestResponseObject result;
if (requestCode == REQUEST_CODE){
if (resultCode == RESULT_OK && data != null){
faceReconResponse = data.getParcelableExtra("FaceReconResponse");
}
}
}