오류 처리

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

콜백 처리

Kotlin
Java

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case 73002: /* camera permission denied — redirect to app settings */ break;
    case 73006: /* running on emulator — physical device required */ break;
    case 73100: /* no internet connection */ break;
    default: /* generic error handling */
  }
}

라이프사이클 콜백

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

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

오류 코드

모든 오류 코드는 UnicoException enum에서 발생하며 ErrorBio(code, message)을 통해 전달됩니다. message 필드에는 SDK의 정확한 문자열이 포함되어 있습니다 — 수정하거나 현지화하지 마십시오.

코드	메시지	설명
`73001`	`Context invalid`	SDK에 전달된 Android 컨텍스트가 유효하지 않음
`73002`	`Did not grant permission to open camera`	사용자가 카메라 권한을 거부함
`73003`	`The lest API is 21(LOLLIPOP`	기기 API 레벨이 최소 요구사항 (API 21) 미만
`73004`	`Could not find implementation interface callback iAcessoBioSelfie`	`iAcessoBioSelfie` 인터페이스가 구현되지 않음
`73005`	`Could not find implementation interface callback iAcessoBioDocument`	`iAcessoBioDocument` 인터페이스가 구현되지 않음
`73006`	`Unable to open camera on emulators`	SDK는 에뮬레이터에서 실행되지 않음 — 실제 기기를 사용하세요
`73007`	`Unknown and unexpected error in WebApp…`	WebApp 일반 오류 (카메라, 스토리지, 보안, 네트워킹)
`73100`	`Unable to connect to internet.`	인터넷 연결 없음
`73200`	`Please inform the config object or json file name`	구성 객체 또는 JSON 파일이 제공되지 않음
`73202`	`Unable to parse json file`	JSON 구성 파일이 손상됨
`73204`	`Unable to initialize the SDK, please configure the environment on setEnviroment method of build`	초기화 전에 `setEnvironment()`가 호출되지 않음
`73300`	`Unable to get unico authentication object`	인증 객체 검색 실패
`73301`	`Unable to parse object`	인증 응답 파싱 실패
`73302`	`Could not find the unico token`	Unico 인증 토큰을 찾을 수 없음
`73303`	`Current host is not registered`	번들 식별자가 SDK Key에 등록되지 않음
`73400`	`Could not initialize camera`	카메라 초기화 실패
`73701`	`Could not find active liveness import`	활성 라이브니스 모듈을 찾을 수 없음
`73703`	`Unable to get active liveness session`	라이브니스 세션 획득 실패
`73718`	`The Session was cancelled because of an unknown and unexpected error…`	알 수 없는 내부 세션 오류
`73721`	`The Session can't be performed: attempts limit exceeded.`	세션 취소 — 캡처 시도 횟수 제한 초과
`73722`	`The Session can't be performed: face alignment timeout.`	세션 취소 — 얼굴 정렬 타임아웃
`73726`	`An error happened during video recording`	라이브니스 중 비디오 녹화 오류
`73727`	`No actions found in a video`	비디오에서 라이브니스 동작이 감지되지 않음
`73740`	`The user pressed the do not consent button and did not complete the Session.`	사용자가 동의를 거부함
`73800`	`Could not build encrypted key.`	암호화된 JWT 구축 실패
`73801`	`The Session of SDK was cancelled because of an unknown and unexpected error.`	알 수 없는 내부 SDK 세션 오류
`73802`	`The Session was cancelled because of an unknown and unexpected error…`	세션 취소 — 필수 JWT 필드 누락
`73900`	`Erro ao analisar imagem`	캡처된 이미지 분석 중 오류
`73901`	`É necessário implementar a interface AcessoBioListener`	`AcessoBioListener` 인터페이스가 구현되지 않음
`73902`	`É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.`	`setTimeoutSession` 값은 40초보다 커야 함
`73903`	`Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.`	구성 파일 손상 — 확인 후 다시 시도하세요
`73904`	`Erro ao finalizar processo`	캡처 프로세스 완료 중 오류
`73905`	`Unable to open document camera`	문서 카메라를 열 수 없음
`73906`	`Document type uninformed`	문서 유형이 지정되지 않음
`74001`	`onSuccess: not implemented when using open:webAppToken:`	User Journey에 대한 `onSuccess` 콜백이 구현되지 않음
`74100`	`Could not prepare SDK-S`	SDK 구성 요소 준비 실패
`74101`	`No URL token was provided.`	journey에 대한 URL 토큰이 제공되지 않음
`74102`	`Environment type was not specified.`	Environment (`PROD`/`UAT`)가 구성되지 않음
`737120`	`Unable to initialize liveness`	라이브니스 activity를 초기화할 수 없음
`737220`	`Capture could not start`	캡처 프로세스를 시작할 수 없음
`737320`	`Transaction could not start`	트랜잭션을 시작할 수 없음
`737321`	`The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.`	세션 공급자 일반 오류 — 다시 시도하세요

REST API 오류 코드

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