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

Web SDK는 언어와 시각적 테마의 두 가지 차원의 커스터마이징을 지원합니다.

## 언어

`setLocale` 메서드를 통해 캡처 프레임의 안내 메시지 언어를 구성하세요. `LocaleTypes` 열거형을 사용하세요:

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

```javascript
import {
  UnicoCheckBuilder,
  LocaleTypes
} from "unico-webframe"

unicoCameraBuilder.setLocale(LocaleTypes.EN_US);
```

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

지원되는 `LocaleTypes` 값의 전체 목록은 [API 레퍼런스 > Enums](/dual-api/developers/sdks-and-tools/web/web-sdk/api-reference/enums)를 참조하세요.

## 테마

`UnicoThemeBuilder`를 사용하여 캡처 프레임을 커스터마이징하세요. 인스턴스를 생성하고 캡처 프레임의 각 속성을 커스터마이징하는 메서드를 호출하세요:

```javascript
const unicoTheme = new UnicoThemeBuilder()
  .setColorSilhouetteSuccess("#0384fc")
  .setBackgroundColor("#dff1f5")
  .setColorText("#0384fc")
  .setBackgroundColorComponents("#0384fc")
  .setColorTextComponents("#dff1f5")
  .setBackgroundColorBoxMessage("#fff")
  .setColorTextBoxMessage("#fff")
  .setBackgroundColorButtons("#0384fc")
  .setColorTextButtons("#dff1f5")
  .setColorCancelButton("#0384fc")
  .setColorProgressBar("#0384fc")
  .setFontFamily("Arial, sans-serif") // v3.19.2+
  .setHtmlPopupLoading(`<div style="position: absolute; top: 45%; right: 50%; transform:
    translate(50%, -50%); z-index: 10; text-align: center;">Loading...</div>`)
  .build();
```

테마 객체를 생성한 후 `setTheme`에 전달하세요:

```javascript
unicoCameraBuilder.setTheme(unicoTheme);
```

:::info[setHtmlPopupLoading]
`setHtmlPopupLoading` 파라미터는 문서 캡처 플로우에만 해당됩니다.
:::

:::warning[커스터마이징 범위]
`UnicoThemeBuilder`가 노출하는 것 외에는 다른 커스터마이징 차원을 사용할 수 없습니다. 완전한 독자적인 UI가 필요한 경우 [캡처 스탠다드](/developers/sdks-and-tools/capture-standard) 옵션(헤드리스 API 통합)을 참조하세요.
:::