오류 처리

Android SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. onErrorAcessoBio 콜백은 code와 description이 포함된 ErrorBio 객체를 수신합니다.

오류 코드

코드	기본 메시지	발생 시점	권장 처리 방법
AUTH_FAILED	SDK authentication failed	잘못되거나 만료된 SDK Key	Onboarding 팀에 자격 증명 확인 요청
CAMERA_PERMISSION_DENIED	Camera permission denied	사용자가 카메라 권한 거부	사용자를 앱 설정으로 안내
LIVENESS_FAILED	Liveness check failed	이미지가 liveness 검증 통과 실패	새로운 캡처 요청
NETWORK_ERROR	Network error during capture	네트워크 연결 불안정	재연결 요청
SDK_NOT_INITIALIZED	SDK not initialized	초기화 전에 캡처 호출	Application/onCreate에서 init 호출 확인

SDK 오류 코드

위의 코드는 SDK 콜백의 주요 오류를 다룹니다. REST API 오류 코드(HTTP 상태 패밀리)는 API 레퍼런스 > 오류 코드에 별도로 문서화되어 있습니다.

콜백 처리

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    "AUTH_FAILED" -> { /* handle authentication failure */ }
    "CAMERA_PERMISSION_DENIED" -> { /* redirect to app settings */ }
    "LIVENESS_FAILED" -> { /* prompt the user to try again */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case "AUTH_FAILED": /* handle authentication failure */ break;
    case "CAMERA_PERMISSION_DENIED": /* redirect to app settings */ break;
    case "LIVENESS_FAILED": /* prompt the user to try again */ break;
    default: /* generic error handling */
  }
}

라이프사이클 콜백

onErrorAcessoBio 외에도 SDK는 다음을 트리거합니다:

• onUserClosedCameraManually() — 사용자가 카메라를 수동으로 닫음.
• onSystemClosedCameraTimeoutSession() — 타임아웃으로 인해 세션 만료.
• onSystemChangedTypeCameraTimeoutFaceInference() — 13초 동안 얼굴이 감지되지 않음; SDK가 수동 캡처로 전환합니다.