Customização

Personalize a aparência da UI do FaceTec no iOS via LivenessFacetecSDKCustomization

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  // LivenessFacetecSDKCustomization.CancelButtonCustomization?
customization.feedback       = nil  // LivenessFacetecSDKCustomization.FeedbackCustomization?
customization.frame          = nil  // LivenessFacetecSDKCustomization.FrameCustomization?
customization.guidance       = nil  // LivenessFacetecSDKCustomization.GuidanceCustomization?
customization.oval           = nil  // LivenessFacetecSDKCustomization.OvalCustomization?
customization.overlay        = nil  // LivenessFacetecSDKCustomization.OverlayCustomization?
customization.resultScreen   = nil  // LivenessFacetecSDKCustomization.ResultScreenCustomization?
customization.vocalGuidance  = nil  // LivenessFacetecSDKCustomization.VocalGuidanceCustomization?

customization.overrideResultScreenSuccessMessage = nil
customization.securityWatermarkImage             = nil

let config = LivenessFacetecSDKConfig(customization: customization)

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

Sub-customizações disponíveis

Propriedade	Tipo	O que controla
cancelButton	LivenessFacetecSDKCustomization.CancelButtonCustomization?	Posição e imagem do botão de cancelar
feedback	LivenessFacetecSDKCustomization.FeedbackCustomization?	Cores e fonte das mensagens de feedback em tela
frame	LivenessFacetecSDKCustomization.FrameCustomization?	Borda, raio e sombra do frame
guidance	LivenessFacetecSDKCustomization.GuidanceCustomization?	Cores e fontes das telas de guia
oval	LivenessFacetecSDKCustomization.OvalCustomization?	Cor e espessura do oval de detecção
overlay	LivenessFacetecSDKCustomization.OverlayCustomization?	Cor de fundo do overlay e branding
resultScreen	LivenessFacetecSDKCustomization.ResultScreenCustomization?	Tela de resultado (cores, animações)
vocalGuidance	LivenessFacetecSDKCustomization.VocalGuidanceCustomization?	Modo de guia por voz
overrideResultScreenSuccessMessage	String?	Mensagem customizada na tela de sucesso
securityWatermarkImage	SecurityWatermarkImage?	Marca-d’água: .faceTec, .faceTecZoom, .none

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 customização exige reinicializar o SDK em uma nova execução do app.

Próximos passos

Implementação

Veja como passar a customização no initialize

Solução de problemas

Diagnostique problemas com cores, fontes e recursos