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

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

## 콜백 처리

### Kotlin

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

### Java

  ```java
  @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.` | 세션 공급자 일반 오류 — 다시 시도하세요 |

:::secondary[REST API 오류 코드]
위의 코드는 SDK 콜백 오류입니다. REST API 오류 코드(HTTP 상태 패밀리)는 [API 레퍼런스 > 오류 코드](/dual-api/developers/api-reference/error-codes)에 별도로 문서화되어 있습니다.
:::