---
title: 캡처 API
canonical: https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/capture-api
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- [SDK 및 도구](/ko/developers/sdks-and-tools/overview)
- [Android SDK](/ko/developers/sdks-and-tools/android/requirements)
- API 레퍼런스
- 캡처 API

# 캡처 API

세션 준비 메서드
SDK 빌더에서 얻은 `UnicoCheckCamera` 인터페이스에서 이 메서드를 호출하세요. 준비 완료 후 `CameraListener.onCameraReady(cameraOpener)` 콜백이 캡처를 시작할 opener를 제공합니다.

| 메서드 | 설명 |
| --- | --- |
| `prepareCamera(config, listener)` | 셀피 카메라를 준비합니다. `listener`는 `CameraListener`입니다. |
| `prepareDocumentCamera(config, listener)` | 문서 카메라를 준비합니  다. `listener`는 `DocumentCameraListener`입니다. |

카메라 열기
`onCameraReady`가 실행된 후 수신된 opener 객체에서 `open`을 호출하세요:

**셀피 — `UnicoCheckCameraOpener.Camera`**

| 메서드 | 설명 |
| --- | --- |
| `open(listener: iAcessoBioSelfie, webAppToken: String)` | 셀피 카메라를 열고, Create Process에서 반환된 `process.webAppToken`을 전달합니다 |

**문서 — `UnicoCheckCameraOpener.Document`**

| 메서드 | 설명 |
| --- | --- |
| `open(documentType: DocumentType, listener: iAcessoBioDocument)` | 지정된 유형의 문서 캡처를 엽니다 |
| `open(documentType: DocumentType, description: String, listener: iAcessoBioDocument)` | 커스텀 설명 레이블과 함께 문서 캡처를 엽니다 |

DocumentType
캡처할 문서 유형을 정의합니다. 전체 목록은 [열거형](/ko/developers/sdks-and-tools/android/api-reference/enums)을 참조하세요.

결과 유형 및 필드
**`ResultCamera`** — 성공 시 반환되는 객체.

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `base64` | `String` | Base64로 인코딩된 캡처 이미지 |
| `encrypted` | `String` | 백엔드로 전송할 JWT |

마지막 업데이트 **2026년 10월 15일**에