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

신분증 문서 캡처. SDK가 사용자의 문서 위치를 안내하는 프레임을 제공하며, 위치를 잡은 후 사용자가 버튼을 클릭하여 사진을 캡처합니다.

:::warning[콘텐츠 유효성 검사 없음]
SDK는 캡처되는 내용에 대한 어떠한 유형의 유효성 검사도 수행하지 않습니다.
:::

## 사용 가능한 문서 프레임

| 프레임 | 설명 |
|---|---|
| `DocumentCameraTypes.CPF` | CPF 캡처 |
| `DocumentCameraTypes.CNH` | 펼쳐진 CNH 캡처 |
| `DocumentCameraTypes.CNH_FRENTE` | CNH 앞면 캡처 |
| `DocumentCameraTypes.CNH_VERSO` | CNH 뒷면 캡처 |
| `DocumentCameraTypes.RG_FRENTE` | RG 앞면 캡처 |
| `DocumentCameraTypes.RG_VERSO` | RG 뒷면 캡처 |
| `DocumentCameraTypes.OUTROS("descrição")` | 다른 문서를 위한 범용 프레임 |

:::tip[범용 프레임]
특정 프레임이 없는 문서를 캡처해야 하는 경우(예: RNE), `DocumentCameraTypes.OUTROS("description")`을 사용하세요 — 모든 캡처를 안내하는 데 사용할 수 있는 범용 직사각형 프레임입니다.
:::

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

## 문서 캡처 시작하기

****2단계** — 문서 리스너 구현**

상태 클래스에 문서 콜백을 추가합니다:

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

  ```dart
  @override
  void onSuccessDocument(ResultCamera resultCamera) { }

  @override
  void onErrorDocument(UnicoError error) { }
  ```

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

`openCameraDocument()` 메서드는 `UnicoCheck` 클래스의 인스턴스로 생성된 객체를 통해 제공됩니다. 다음을 인자로 받습니다:

  - [자격 증명 설정 단계](/developers/sdks-and-tools/flutter/installation/specific-setup)에서 생성된 자격 증명이 담긴 JSON 파일;
  - 캡처할 문서 유형(`DocumentType` 열거형);
  - 2단계에서 구성된 리스너.

  펼쳐진 CNH를 사용하는 예시:

  ```dart
  _unicoCheck.build().openCameraDocument(
    jsonFileName: androidJsonFileName,
    documentType: DocumentType.CNH,
    listener: this,
  );
  ```

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