Personalização da UI

Links rápidos: Visão geral | Compilando o SDK | Iniciar verificação de vivacidade | Personalização da UI | Instalação | Versão atual | Requisitos | Código-fonte | Referência de resultados | Notas de versão | FAQ

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

• 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.

Exemplo — personalização completa

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.

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.