---
title: 自定义 API
canonical: https://developer.unico.io/zh-CN/dual-api/developers/sdks-and-tools/android/api-reference/customization-api
locale: zh-CN
generated_by: markdown-export
---

## 应用自定义主题

使用 `setTheme()` 将主题实现传递给 builder：

```kotlin
acessoBioBuilder.setTheme(myTheme)
```

其中 `myTheme` 是实现 `IAcessoBioTheme` 接口的对象。

## IAcessoBioTheme — 自拍

| 方法 | 描述 |
|---|---|
| `getColorBackground()` | 自拍采集框的背景颜色 |
| `getColorBoxMessage()` | 消息框的背景颜色 |
| `getColorTextMessage()` | 消息框内的文字颜色 |
| `getColorSilhouetteSuccess()` | 采集成功时的轮廓颜色 |

## IAcessoBioTheme — 文件

| 方法 | 描述 |
|---|---|
| `getColorBackground()` | 文件采集框的背景颜色 |
| `getColorBackgroundTakePictureButton()` | 拍照按钮的背景颜色 |
| `getColorIconTakePictureButton()` | 拍照按钮内的图标颜色 |
| `getColorBackgroundBottomDocument()` | 底部栏的背景颜色 |
| `getColorTextBottomDocument()` | 底部栏的文字颜色 |

## Locale

| 方法 | 类型 | 描述 |
|---|---|---|
| `setLocale(locale: LocaleTypes)` | `LocaleTypes` | 设置采集界面语言 |

支持的 `LocaleTypes` 值完整列表，请参见 [API 参考 > 枚举](/developers/sdks-and-tools/android/api-reference/enums)。

## XML 颜色资源

您也可以通过应用的 `colors.xml` 资源文件覆盖颜色。SDK 可识别以下资源名称：

| 资源名称 | 默认值 | 描述 |
|---|---|---|
| `unico_color_background` | `#F9F8FA` | 采集框背景 |
| `unico_color_silhouette_success` | `#22C532` | 对齐时的轮廓颜色 |
| `unico_color_silhouette_error` | `#FFCB00` | 错误时的轮廓颜色 |
| `unico_color_silhouette_neutral` | `#000000` | 轮廓颜色（中性） |
| `unico_color_box_message` | `#1172EB` | 消息框背景 |
| `unico_color_text_message` | `#0B0B0B` | 消息框内文字 |
| `unico_color_background_take_picture_button` | `#1172EB` | 采集按钮背景 |
| `unico_color_icon_take_picture_button` | `#FFFFFF` | 采集按钮图标颜色 |
| `unico_color_background_bottom_document` | `#FFFFFF` | 文件底部栏背景 |
| `unico_color_text_bottom_document` | `#404040` | 文件底部栏文字 |