> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/ui-customization.md). # Personalização da interface Links rápidos: [Visão geral](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite.md) | [Compilando o SDK](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/builder.md) | [Iniciar verificação de vivacidade](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/start-sdk.md) | [Personalização da UI](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/ui-customization.md) | [Instalação](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/installation.md) | [Versão atual](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/current-version.md) | [Requisitos](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/requirements.md) | [Código-fonte](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/source-code.md) | [Referência de resultados](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/result-reference.md) | [Notas de versão](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/release-notes.md) | [FAQ](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/faq_caf_face_liveness_sdk.md) De **2.1.0**, `CafFaceLivenessLite` aceita um `uiCustomization` parâmetro opcional para adequar a tela de liveness à sua marca. Tudo é opcional: omita o parâmetro — ou deixe campos individuais `nil` — e a tela mantém sua aparência padrão. De **3.0.0** este parâmetro é passado para `setup` em vez de para `startSDK`. ## CerttaUiCustomization | Propriedade | Tipo | Padrão | Descrição | | ----------- | ---------------------------- | ------ | --------------------------------------------------------------- | | `mask` | `CerttaMaskCustomization?` | `nil` | Área ao redor do oval do rosto | | `appBar` | `CerttaAppBarCustomization?` | `nil` | Barra de cabeçalho: título, logo e botão de fechar | | `prompt` | `CerttaPromptCustomization?` | `nil` | Mensagem de orientação exibida ao usuário durante a captura | | `fontName` | `String?` | `nil` | Fonte usada tanto para o título quanto para o texto da mensagem | ## CerttaAppBarCustomization | Propriedade | Tipo | Padrão | Descrição | | ---------------------- | ---------- | --------------- | ---------------------------------------------- | | `title` | `String?` | sem título | Texto do título exibido no topo da tela | | `titleColor` | `UIColor?` | `.white` | Cor do texto do título | | `color` | `UIColor?` | transparente | Cor de fundo da barra de cabeçalho | | `closeButton` | `UIImage?` | ícone integrado | Imagem usada para o botão de fechar | | `closeButtonTintColor` | `UIColor?` | `.white` | Cor de tonalização aplicada ao botão de fechar | | `logoIcon` | `UIImage?` | sem logo | Logo exibido ao lado do título | ## CerttaPromptCustomization | Propriedade | Tipo | Padrão | Descrição | | ----------------- | ---------- | ----------------- | -------------------------------------------------------- | | `textColor` | `UIColor?` | `.white` | Cor do texto da mensagem | | `backgroundColor` | `UIColor?` | preto translúcido | Cor de fundo da mensagem | | `isRounded` | `Bool` | `verdadeiro` | Indica se a mensagem é desenhada com cantos arredondados | ## CerttaMaskCustomization | Propriedade | Tipo | Padrão | Descrição | | --------------- | ---------- | ----------------- | -------------------------------------------------------------------------- | | `isBlurEnabled` | `Bool` | `verdadeiro` | Indica se o efeito de desfoque e vinheta fora do oval do rosto é desenhado | | `color` | `UIColor?` | preto translúcido | Cor aplicada à área fora do oval do rosto | {% hint style="info" %} * Somente os valores que você definir são aplicados — todo campo deixado `nil` mantém seu padrão. * `isBlurEnabled` e `isRounded` não são opcionais. Quando você fornece um `mask` ou `prompt` bloco, seus valores são sempre aplicados, mas ambos têm como padrão `verdadeiro`, o que é exatamente o comportamento atual — uma personalização parcial não pode alterá-los por acidente. * `fontName` deve ser uma fonte disponível para o seu app (uma fonte do sistema ou uma registrada pelo seu bundle). Se o nome não puder ser resolvido, ele é ignorado e a fonte padrão é mantida. Aplica-se tanto ao título quanto ao texto da mensagem. {% endhint %} ## Exemplo — personalização completa ```swift import CafFaceLivenessLite let customization = CerttaUiCustomization( mask: CerttaMaskCustomization( isBlurEnabled: true, color: UIColor.black.withAlphaComponent(0.6) ), appBar: CerttaAppBarCustomization( title: "Verificação facial", titleColor: .white, color: UIColor(red: 0.11, green: 0.13, blue: 0.35, alpha: 1.0), closeButton: UIImage(named: "close_icon"), closeButtonTintColor: .white, logoIcon: UIImage(named: "brand_logo") ), prompt: CerttaPromptCustomization( textColor: .white, backgroundColor: UIColor.black.withAlphaComponent(0.8), isRounded: true ), fontName: "HelveticaNeue-Medium" ) sdk.setup( mobileToken: "your_mobile_token", personId: "your_person_id", customLocalization: nil, customLocalizationBundle: nil, uiCustomization: customization, environment: .prod, loading: true ) sdk.startSDK(viewController: self) ``` ## Exemplo — personalização parcial Personalize apenas o que precisar; todo o resto permanece no padrão. ```swift let customization = CerttaUiCustomization( appBar: CerttaAppBarCustomization( title: "Verificação facial", color: UIColor(red: 0.11, green: 0.13, blue: 0.35, alpha: 1.0) ) ) sdk.setup( mobileToken: "your_mobile_token", personId: "your_person_id", customLocalization: nil, customLocalizationBundle: nil, uiCustomization: customization, environment: .prod, loading: true ) sdk.startSDK(viewController: self) ``` Para personalizar os **textos** exibidos na tela em vez da aparência, use `customLocalization` e `customLocalizationBundle` — veja [Iniciar verificação de vivacidade](/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/start-sdk.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-sdk/caf-sdk-pt-br/ios/standalone-modules/caffacelivenesslite/ui-customization.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.