---
title: 커스터마이징
canonical: https://developer.unico.io/ko/dual-api/developers/sdks-and-tools/flutter/customization
locale: ko
generated_by: markdown-export
---

:::warning[캡처 플로우 가용성]
이 커스터마이징은 캡처 플로우가 **`document-capture`** 또는 **`liveness`**인 경우에만 사용 가능합니다.
:::

Flutter SDK는 기반 네이티브 SDK로부터 상속된 두 가지 차원의 커스터마이징을 지원합니다: 언어와 색상.

## 언어

`setLocale` 메서드를 통해 캡처 프레임의 안내 메시지 언어를 설정합니다. `LocaleTypes` 열거형을 사용합니다:

- `LocaleTypes.PT_BR` — 포르투갈어 (브라질)
- `LocaleTypes.ES_MX` — 스페인어 (멕시코)
- `LocaleTypes.ES_ES` — 스페인어 (스페인)
- `LocaleTypes.EN_US` — 영어 (미국)

```dart
unicoCheck.setLocale(LocaleTypes.EN_US);
```

:::info
- 이 기능을 사용하려면 원격 활성화가 필요할 수 있습니다. 사용을 원하신다면 프로젝트 매니저 또는 Unico 지원팀에 알려주세요.
- 설정하지 않으면 SDK는 포르투갈어를 기본 언어로 사용합니다.
:::

지원되는 `LocaleTypes` 값의 전체 목록은 [API 참조 > 열거형](/developers/sdks-and-tools/flutter/api-reference/enums)을 참조하세요.

## 색상

지원되는 메서드를 구성하여 커스텀 테마를 적용합니다. 색상 값은 **16진수 문자열** (예: `"#FF0000"`) 또는 Flutter `Color` 인스턴스 (예: `Color(0xFFFF0000)`)로 전달할 수 있습니다.

| 메서드 | 커스터마이징 대상 |
|---|---|
| `getColorBackground()` | 실루엣 배경 색상 |
| `getColorBoxMessage()` | 메시지 박스 배경 색상 |
| `getColorTextMessage()` | 메시지 박스 내부 텍스트 색상 |
| `getColorIconTakePictureButton()` | 수동 사진 캡처 버튼의 아이콘 색상 |
| `getColorBackgroundBottomDocument()` | 문서 캡처 박스 배경 색상 |
| `getColorTextBottomDocument()` | 문서 캡처 박스 텍스트 색상 |

:::warning[취소 버튼 색상 (Android)]
Android 구현에서 `colorCancelButtonIcon`의 커스터마이징은 Android `colors.xml` 리소스 파일에 원하는 색상을 추가하여 수행해야 합니다:

```xml
<resources>
  <color name="unico_color_button_cancel">YOUR COLOR</color>
</resources>
```
:::

:::warning[커스터마이징 범위]
다른 커스터마이징 차원은 사용할 수 없습니다 — 기반 네이티브 SDK가 노출하지 않으므로 Flutter 플러그인도 제공할 수 없습니다. 독자적인 UI가 필요한 경우 [Capture Standard](/developers/sdks-and-tools/capture-standard) 옵션(헤드리스 API 통합)을 참조하세요.
:::