---
title: 문서 캡처
canonical: https://developer.unico.io/ko/dual-api/developer/sdks-and-tools/android-sdk/document-capture/
locale: ko
generated_by: markdown-export
---

신분증 문서 캡처. [문서 캡처 및 재사용](/capabilities/document-reuse-and-capture) 기능과 결합하면 **RG**(앞면만 또는 앞뒤 모두), **CNH**(앞뒤 모두), **CPF**를 지원합니다.

지원되는 문서 유형의 전체 목록과 열거형 값은 [API 레퍼런스 > Enums](/developers/sdks-and-tools/android/api-reference/enums)를 참조하세요.

## 문서 캡처 시작하기

****2단계** — `iAcessoBioDocument` 구현**

`iAcessoBioDocument`는 문서 캡처 결과 콜백을 처리합니다:

  | 메서드 | 설명 |
  |---|---|
  | `onSuccessDocument(result)` | 캡처 성공 — `base64`(미리보기)와 `encrypted`(API용 JWT)가 포함된 `ResultCamera` 반환 |
  | `onErrorDocument(errorBio)` | 캡처 실패 — 코드와 설명이 포함된 `ErrorBio` 반환 |

  ### Kotlin

    ```kotlin
    val documentListener = object : iAcessoBioDocument {
      override fun onSuccessDocument(result: ResultCamera?) { }
      override fun onErrorDocument(errorBio: ErrorBio?) { }
    }
    ```

### Java

    ```java
    iAcessoBioDocument documentListener = new iAcessoBioDocument() {
      @Override
      public void onSuccessDocument(ResultCamera result) { }

      @Override
      public void onErrorDocument(ErrorBio errorBio) { }
    };
    ```

****3단계** — `prepareDocumentCamera` 호출**

`acessoBioBuilder`가 초기화되고 두 리스너가 모두 구현된 상태에서, SDK 구성([초기화](/developers/sdks-and-tools/android/initialization)에서 생성한 `UnicoConfig`), 원하는 `DocumentType`, `DocumentCameraListener`를 전달하여 `prepareDocumentCamera`를 호출합니다:

  - `onCameraReady` — 카메라가 준비됨; 2단계의 `documentListener`를 전달하여 `open`을 호출합니다.
  - `onCameraFailed` — 카메라 준비 실패; 오류 메시지를 처리합니다.

  ### Kotlin

    ```kotlin
    acessoBioBuilder
      .build()
      .prepareDocumentCamera(UnicoConfig(), DocumentType.CNH, object : DocumentCameraListener {
        override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
          cameraOpener?.open(documentListener)
        }
        override fun onCameraFailed(message: String?) { }
      })
    ```

### Java

    ```java
    acessoBioBuilder
      .build()
      .prepareDocumentCamera(new UnicoConfig(), DocumentType.CNH, new DocumentCameraListener() {
        @Override
        public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
          cameraOpener.open(documentListener);
        }

        @Override
        public void onCameraFailed(String message) { }
      });
    ```

전체 결과 처리 방법은 [결과 수신](/developers/sdks-and-tools/android/capture-flow/receiving-the-result)을 참조하세요.