---
title: 오류 처리
canonical: https://developer.unico.io/ko/developers/sdks-and-tools/android/error-handling
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- [SDK 및 도구](/ko/developers/sdks-and-tools/overview)
- [Android SDK](/ko/developers/sdks-and-tools/android/requirements)
- 오류 처리

# 오류 처리

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 */ }  }}
```

```
@Overridepublic 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 레퍼런스 > 오류 코드](/ko/developers/start/error-codes)에 별도로 문서화되어 있습니다.마지막 업데이트 2026년 10월 8일**에