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

:::warning[采集流程可用性]
这些自定义选项仅在采集流程为 **`document-capture`** 或 **`liveness`** 时可用。
:::

iOS SDK 支持两个维度的自定义：语言和颜色。

## 语言

通过 `setLocale` 方法配置采集界面中提示信息的语言。使用 `LocaleTypes` 枚举：

- `LocaleTypes.PT_BR` — 葡萄牙语（巴西）
- `LocaleTypes.ES_MX` — 西班牙语（墨西哥）
- `LocaleTypes.ES_ES` — 西班牙语（西班牙）
- `LocaleTypes.EN_US` — 英语（美国）

### Swift

  ```swift
  unicoCheck.setLocale(.EN_US)
  ```

### Objective-C

  ```objectivec
  [unicoCheck setLocale:EN_US];
  ```

:::info
- 使用此功能可能需要远程激活。如需使用，请通知您的项目经理或 Unico 支持团队。
- 如果未配置，SDK 默认使用葡萄牙语。
:::

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

## 颜色

通过实现 `AcessoBioThemeDelegate` 并在 `AcessoBioManager` 上调用 `setTheme(self)` 来应用自定义主题。每个方法返回 `Any!`，接受 **`UIColor` 实例**或**十六进制字符串**（例如 `"#FF0000"`）。

| 方法 | 自定义内容 |
|---|---|
| `getColorBackground()` | 轮廓的背景颜色 |
| `getColorBackgroundBottomDocument()` | 文档采集框的背景颜色 |
| `getColorBoxMessage()` | 消息框的背景颜色 |
| `getColorIconTakePictureButton()` | 手动拍照按钮的图标颜色 |
| `getColorSilhouetteSuccess()` | 采集成功时的轮廓颜色 |
| `getColorTextBottomDocument()` | 文档采集框的文字颜色 |
| `getColorTextMessage()` | 消息框内的文字颜色 |
| `getCancelButtonIconColor()` *（可选）* | 带交互的活体检测相机的取消图标颜色。如果未实现，则使用 `getColorBackgroundTakePictureButton()`。 |

### Swift

  ```swift
  import UIKit
  import AcessoBio

  class ViewController: UIViewController, AcessoBioManagerDelegate, AcessoBioThemeDelegate {
    var unicoCheck: AcessoBioManager!

    override func viewDidLoad() {
      super.viewDidLoad()
      unicoCheck = AcessoBioManager(viewController: self)
      unicoCheck.setTheme(self)
    }

    func getColorBackground() -> Any! { /* return color */ }
    func getColorBoxMessage() -> Any! { /* return color */ }
    func getColorTextMessage() -> Any! { /* return color */ }
    func getColorIconTakePictureButton() -> Any! { /* return color */ }
    func getColorBackgroundBottomDocument() -> Any! { /* return color */ }
    func getColorTextBottomDocument() -> Any! { /* return color */ }
    func getColorSilhouetteSuccess() -> Any! { /* return color */ }
    func getCancelButtonIconColor() -> Any! { /* return color */ }
  }
  ```

### Objective-C

  ```objectivec
  // .h
  #import "AcessoBioThemeDelegate.h"

  @interface ViewController : UIViewController
  @end

  // .m
  - (id)getColorBackground { /* return color */ }
  - (id)getColorBackgroundBottomDocument { /* return color */ }
  - (id)getColorBoxMessage { /* return color */ }
  - (id)getColorIconTakePictureButton { /* return color */ }
  - (id)getColorSilhouetteSuccess { /* return color */ }
  - (id)getColorTextBottomDocument { /* return color */ }
  - (id)getColorTextMessage { /* return color */ }
  - (id)getCancelButtonIconColor { /* return color */ }
  ```

:::warning[自定义范围]
没有其他可用的自定义维度。原生 iOS SDK 不提供自定义 UI 行为和布局。如果您需要专有 UI，请参考 [Capture Standard](/developers/sdks-and-tools/capture-standard) 选项（无头 API 集成）。
:::