Customização

A UI da captura é renderizada pelo próprio FaceTec SDK. Você consegue personalizá-la passando um LivenessFacetecSDKCustomization em LivenessFacetecSDKConfig. Cada propriedade é um espelho tipado da customização correspondente do FaceTec — quando você define um campo, ele é aplicado; quando deixa nil, o FaceTec usa o padrão.

Estrutura geral

import LivenessFacetecSDK

var customization = LivenessFacetecSDKCustomization()

// Defina apenas o que precisar — tudo é opcional.
customization.cancelButton      = nil  // CancelButtonCustomization?
customization.feedback          = nil  // FeedbackCustomization?
customization.frame             = nil  // FrameCustomization?
customization.guidance          = nil  // GuidanceCustomization?
customization.oval              = nil  // OvalCustomization?
customization.overlay           = nil  // OverlayCustomization?
customization.resultScreen      = nil  // ResultScreenCustomization?
customization.vocalGuidance     = nil  // VocalGuidanceCustomization?
customization.orientationScreen = nil  // OrientationScreenCustomization?

let config = LivenessFacetecSDKConfig(customization: customization)

try await LivenessFacetecSDKClient.shared.initialize(config: config)

Sub-customizações disponíveis

Propriedade	Tipo	O que controla
`cancelButton`	`CancelButtonCustomization?`	Posição e imagem do botão de cancelar
`feedback`	`FeedbackCustomization?`	Cores e fonte das mensagens de feedback em tela
`frame`	`FrameCustomization?`	Borda, raio e sombra do frame
`guidance`	`GuidanceCustomization?`	Cores e fontes das telas de guia (“pronto” e “tente novamente”)
`oval`	`OvalCustomization?`	Cor e espessura do oval de detecção e do indicador de progresso
`overlay`	`OverlayCustomization?`	Cor de fundo do overlay e imagem de branding
`resultScreen`	`ResultScreenCustomization?`	Tela de resultado (cores, animações, barra de upload)
`vocalGuidance`	`VocalGuidanceCustomization?`	Modo de guia por voz e arquivos de som
`orientationScreen`	`OrientationScreenCustomization?`	Tela exibida quando o dispositivo está em orientação não suportada
`exitAnimationSuccess` / `exitAnimationUnsuccess`	`ExitAnimationStyle?`	Estilo da animação de saída da sessão
`securityWatermarkImage`	`SecurityWatermarkImage?`	Marca-d’água de segurança exibida durante a captura
`strings`	`[StringKey: String]?`	Sobrescreve textos localizados da UI do FaceTec
`featureFlags`	`[String: Any]?`	Passthrough para feature flags da FaceTec, tipicamente fornecidas pelo suporte deles

Enums:

Enum	Casos
`CancelButtonLocation`	`.topLeft`, `.topRight`, `.disabled`, `.custom`
`VocalGuidanceMode`	`.noVocalGuidance`, `.minimalVocalGuidance`, `.fullVocalGuidance`
`SecurityWatermarkImage`	`.faceTec`, `.faceTecZoom`, `.poweredBy`
`ExitAnimationStyle`	`.none`, `.rippleOut`, `.rippleOutSlow`

Não definir securityWatermarkImage (deixar nil) produz o watermark padrão, .faceTec. A FaceTec não oferece uma opção nativa de “sem watermark”.

Temas alternativos

Todas as propriedades acima vivem, na verdade, dentro de LivenessFacetecSDKCustomization.Theme — as propriedades de nível superior (customization.oval, customization.frame, etc.) são atalhos para customization.theme.oval, customization.theme.frame, e assim por diante. Isso existe porque a FaceTec permite configurar dois temas alternativos completos, aplicados automaticamente conforme a condição do ambiente:

Campo	Tipo	Quando é aplicado
`lowLight`	`Theme?`	Ambientes de pouca luz
`dynamicDimming`	`Theme?`	Durante o dimming dinâmico da tela

Ambos aceitam exatamente o mesmo formato do tema padrão. Se não forem definidos, a FaceTec usa customization.theme também nessas condições.

var lowLightTheme = LivenessFacetecSDKCustomization.Theme()
var lowLightFrame = LivenessFacetecSDKCustomization.FrameCustomization()
lowLightFrame.backgroundColor = .black
lowLightTheme.frame = lowLightFrame

customization.lowLight = lowLightTheme

Textos da interface

strings: [StringKey: String]? sobrescreve os textos localizados da interface da FaceTec. O enum StringKey cobre o subconjunto de chaves aplicável a um fluxo de 3D Liveness.

customization.strings = [
    .actionImReady: "Estou pronto",
    .resultFacescanSuccess3dEnrollmentMessage: "Verificação concluída!",
    .resultFacescanSuccess3d3dReverificationMessage: "Verificação concluída!"
]

A FaceTec decide no backend se uma sessão é tratada como “Enrollment” (primeiro FaceMap do usuário) ou “3D-to-3D Reverification” (comparação com FaceMap existente) — o app iOS não sabe qual mensagem vai aparecer. Para garantir o mesmo texto de sucesso em qualquer caso, sobrescreva as duas chaves (resultFacescanSuccess3dEnrollmentMessage e resultFacescanSuccess3d3dReverificationMessage) com o mesmo valor.

Exemplo: cores do oval e overlay sem branding

import LivenessFacetecSDK
import UIKit

var customization = LivenessFacetecSDKCustomization()

var oval = LivenessFacetecSDKCustomization.OvalCustomization()
oval.strokeColor    = UIColor(red: 0.72, green: 0.16, blue: 0.10, alpha: 1.0)
oval.progressColor1 = UIColor(red: 0.72, green: 0.16, blue: 0.10, alpha: 1.0)
oval.progressColor2 = UIColor(red: 0.91, green: 0.27, blue: 0.29, alpha: 1.0)
customization.oval = oval

var overlay = LivenessFacetecSDKCustomization.OverlayCustomization()
overlay.showBrandingImage = false
customization.overlay = overlay

let config = LivenessFacetecSDKConfig(customization: customization)
try await LivenessFacetecSDKClient.shared.initialize(config: config)

Boas práticas

Mudanças visuais profundas no fluxo do FaceTec precisam respeitar as diretrizes de marca da própria FaceTec — em especial, a marca-d’água de segurança (securityWatermarkImage) não deve ser ocultada sob risco de violar o contrato de uso do motor.

Mantenha contraste suficiente entre o oval guia e o fundo para preservar a acessibilidade.
Evite fontes muito pequenas em guidance — o FaceTec já balanceia tamanhos para legibilidade em câmeras frontais.
Teste em iPhones de tela compacta (SE/Mini) — alguns elementos posicionados manualmente podem sobrepor o oval.
Reuse o mesmo LivenessFacetecSDKCustomization entre o initialize e chamadas subsequentes; trocar a customização exige stop() seguido de um novo initialize().

Próximos passos

Implementação

Veja como passar a customização no initialize

Solução de problemas

Diagnostique problemas com cores, fontes e recursos

Primeiros Passos

Onboarding

Bureau

Liveness

Assinatura Digital

ID Check

Card Check

TrustPass

BPO

Extração Dados

Mensageria

Documentoscopia

Storage

Coleção Postman

Estrutura geral

Sub-customizações disponíveis

Temas alternativos

Textos da interface

Exemplo: cores do oval e overlay sem branding

Boas práticas

Próximos passos

Implementação

Solução de problemas

​Estrutura geral

​Sub-customizações disponíveis

​Temas alternativos

​Textos da interface

​Exemplo: cores do oval e overlay sem branding

​Boas práticas

​Próximos passos

Implementação

Solução de problemas

Estrutura geral

Sub-customizações disponíveis

Temas alternativos

Textos da interface

Exemplo: cores do oval e overlay sem branding

Boas práticas

Próximos passos