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

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

Android SDK는 언어와 색상 두 가지 차원의 커스터마이징을 지원합니다.

## 언어

`setLocale` 메서드를 통해 캡처 화면의 안내 메시지 언어를 설정합니다:

### Kotlin

  ```kotlin
  acessoBioBuilder.setLocale(LocaleTypes.EN_US)
  ```

### Java

  ```java
  acessoBioBuilder.setLocale(LocaleTypes.EN_US);
  ```

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

## 색상

`acessoBioBuilder`에서 `setTheme`을 사용하여 커스텀 테마를 적용합니다. 색상 값은 **Color Resource**(`R.color.your_color`) 또는 **16진수 문자열**(`"#FF0000"`)로 전달할 수 있습니다.

`IAcessoBioTheme` 인터페이스는 캡처 유형에 따라 다양한 메서드를 노출합니다.

****셀피 캡처****

| 메서드 | 커스터마이징 대상 |
  |---|---|
  | `getColorBackground()` | 셀피 캡처 화면의 배경 색상 |
  | `getColorBoxMessage()` | 메시지 박스의 배경 색상 |
  | `getColorTextMessage()` | 메시지 박스 내부의 텍스트 색상 |
  | `getColorSilhouetteSuccess()` | 캡처 성공 시 실루엣 색상 |

  ### Kotlin

    ```kotlin
    val unicoTheme = object : IAcessoBioTheme {
      override fun getColorBackground() = R.color.your_color
      override fun getColorBoxMessage() = R.color.your_color
      override fun getColorTextMessage() = R.color.your_color
      override fun getColorSilhouetteSuccess() = R.color.your_color
    }
    acessoBioBuilder.setTheme(unicoTheme)
    ```

### Java

    ```java
    IAcessoBioTheme unicoTheme = new IAcessoBioTheme() {
      @Override
      public Object getColorBackground() { return R.color.your_color; }

      @Override
      public Object getColorBoxMessage() { return R.color.your_color; }

      @Override
      public Object getColorTextMessage() { return R.color.your_color; }

      @Override
      public Object getColorSilhouetteSuccess() { return R.color.your_color; }
    };
    acessoBioBuilder.setTheme(unicoTheme);
    ```

  또는 `colors.xml`에서 색상을 정적으로 재정의할 수 있습니다:

  ```xml
  <color name="unico_color_background">#YourColor</color>
  <color name="unico_color_box_message">#YourColor</color>
  <color name="unico_color_text_message">#YourColor</color>
  <color name="unico_color_silhouette_success">#YourColor</color>
  <color name="unico_color_button_cancel">#YourColor</color>
  ```

  :::info
  `unico_color_button_cancel`은 `colors.xml`을 통해서만 사용할 수 있으며 `IAcessoBioTheme`의 메서드로는 노출되지 않습니다.
  :::

****문서 캡처****

| 메서드 | 커스터마이징 대상 |
  |---|---|
  | `getColorBackground()` | 문서 캡처 화면의 배경 색상 |
  | `getColorBackgroundTakePictureButton()` | 사진 촬영 버튼의 배경 색상 |
  | `getColorIconTakePictureButton()` | 사진 촬영 버튼 내부의 아이콘 색상 |
  | `getColorBackgroundBottomDocument()` | 하단 바의 배경 색상 |
  | `getColorTextBottomDocument()` | 하단 바의 텍스트 색상 |

  ### Kotlin

    ```kotlin
    val unicoTheme = object : IAcessoBioTheme {
      override fun getColorBackground() = R.color.your_color
      override fun getColorBackgroundTakePictureButton() = R.color.your_color
      override fun getColorIconTakePictureButton() = R.color.your_color
      override fun getColorBackgroundBottomDocument() = R.color.your_color
      override fun getColorTextBottomDocument() = R.color.your_color
    }
    acessoBioBuilder.setTheme(unicoTheme)
    ```

### Java

    ```java
    IAcessoBioTheme unicoTheme = new IAcessoBioTheme() {
      @Override
      public Object getColorBackground() { return R.color.your_color; }

      @Override
      public Object getColorBackgroundTakePictureButton() { return R.color.your_color; }

      @Override
      public Object getColorIconTakePictureButton() { return R.color.your_color; }

      @Override
      public Object getColorBackgroundBottomDocument() { return R.color.your_color; }

      @Override
      public Object getColorTextBottomDocument() { return R.color.your_color; }
    };
    acessoBioBuilder.setTheme(unicoTheme);
    ```

  또는 `colors.xml`에서 색상을 정적으로 재정의할 수 있습니다:

  ```xml
  <color name="unico_color_background">#YourColor</color>
  <color name="unico_color_background_take_picture_button">#YourColor</color>
  <color name="unico_color_icon_take_picture_button">#YourColor</color>
  <color name="unico_color_background_bottom_document">#YourColor</color>
  <color name="unico_color_text_bottom_document">#YourColor</color>
  ```

:::warning[커스터마이징 범위]
다른 커스터마이징 차원은 제공되지 않습니다. 커스텀 UI 동작 및 레이아웃은 네이티브 Android SDK에서 지원하지 않습니다. 독자적인 UI가 필요한 경우 [Capture Standard](/developers/sdks-and-tools/capture-standard) 옵션(헤드리스 API 통합)을 참조하세요.
:::