> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Customização

> Personalize a UI de captura do IDENTY Face AI via LivenessIdentySDKCustomization

A UI da captura é renderizada pelo próprio IDENTY Face AI SDK. Você consegue personalizá-la passando um `LivenessIdentySDKCustomization` em `LivenessIdentySDKConfig`.

## Estrutura geral

```kotlin theme={"theme":"catppuccin-latte"}
import com.vcc.vendor.identy.sdk.models.LivenessIdentySDKConfig
import com.vcc.vendor.identy.sdk.models.LivenessIdentySDKCustomization
import com.vcc.vendor.identy.sdk.models.LivenessIdentySDKUiOption
import com.vcc.vendor.identy.sdk.LivenessIdentySDK

val customization = LivenessIdentySDKCustomization(
    uiOption = LivenessIdentySDKUiOption.STANDARD, // STANDARD | TICKING | TICKING_V2
    enableTraining = true,
    showBackButton = false,
    locale = null
)

LivenessIdentySDK.init(
    applicationContext = applicationContext,
    config = LivenessIdentySDKConfig(
        customization = customization
    )
)
```

## Campos disponíveis

| Campo | Tipo | Padrão | Descrição |
| - | - | - | - |
| `uiOption` | `LivenessIdentySDKUiOption?` | `null` | Estilo de UI da tela de captura (`STANDARD`, `TICKING` ou `TICKING_V2`); mapeado internamente para a opção equivalente do vendor |
| `enableTraining` | `Boolean` | `true` | Habilita a tela de treinamento/instruções do vendor antes da captura |
| `showBackButton` | `Boolean` | `false` | Exibe botão de voltar na UI do vendor |
| `locale` | `String?` | `null` | Locale para os textos da UI do vendor |

## Exemplo: pular tela de treinamento e habilitar botão de voltar

```kotlin theme={"theme":"catppuccin-latte"}
import com.vcc.vendor.identy.sdk.models.LivenessIdentySDKCustomization
import com.vcc.vendor.identy.sdk.models.LivenessIdentySDKUiOption

val customization = LivenessIdentySDKCustomization(
    uiOption = LivenessIdentySDKUiOption.TICKING_V2,
    enableTraining = false,
    showBackButton = true,
    locale = "pt-BR"
)
```

## Boas práticas

* **Reuse o mesmo `LivenessIdentySDKCustomization`** entre o `init` e chamadas subsequentes; a customização é aplicada no `init()`, então trocá-la exige chamar `LivenessIdentySDK.stop()` e depois `init()` de novo com a nova configuração.
* **Teste os três valores de `uiOption`** (`STANDARD`, `TICKING`, `TICKING_V2`) antes de fixar um — cada um altera significativamente o fluxo visual apresentado pelo vendor.
* **Avalie manter `enableTraining = true`** em integrações novas — a tela de treinamento reduz capturas reprovadas por posicionamento incorreto.

## Próximos passos

> **[Implementação](https://docs-platform.services-valid.com.br/plataforma/liveness/identy/sdk/android/implementacao.md)**
>
> Veja como passar a customização no `init`

> **[Solução de problemas](https://docs-platform.services-valid.com.br/plataforma/liveness/identy/sdk/android/troubleshooting.md)**
>
> Diagnostique problemas de configuração e build


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.