---
title: 自定义
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/android/customization
locale: zh-CN
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` 应用自定义主题。颜色值可以作为**颜色资源**（`R.color.your_color`）或**十六进制字符串**（`"#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[自定义范围]
没有其他可用的自定义维度。原生 Android SDK 不提供自定义 UI 行为和布局。如果您需要专有 UI，请参阅 [Capture Standard](/developers/sdks-and-tools/capture-standard) 选项（无界面 API 集成）。
:::