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

## UnicoThemeBuilder 方法

| 方法 | 描述 |
|---|---|
| `setColorSilhouetteSuccess(color)` | 采集成功时的轮廓颜色 |
| `setBackgroundColor(color)` | 采集框的背景颜色 |
| `setColorText(color)` | 文本颜色 |
| `setBackgroundColorComponents(color)` | UI 组件的背景颜色 |
| `setColorTextComponents(color)` | UI 组件内部的文本颜色 |
| `setBackgroundColorBoxMessage(color)` | 消息框的背景颜色 |
| `setColorTextBoxMessage(color)` | 消息框内部的文本颜色 |
| `setBackgroundColorButtons(color)` | 按钮的背景颜色 |
| `setColorTextButtons(color)` | 按钮的文本颜色 |
| `setColorCancelButton(color)` | 取消按钮颜色 |
| `setColorProgressBar(color)` | 进度条颜色 |
| `setFontFamily(font)` *(v3.19.2+)* | 采集框的字体系列 |
| `setHtmlPopupLoading(html)` | 加载弹窗的自定义 HTML（仅限文件采集） |
| `build()` | 返回 `UnicoTheme` 实例 |

:::warning[颜色值类型]
支持的颜色类型为**十六进制字符串**（例如 `"#FF0000"`）。
:::

## 语言区域

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

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