Liveness 3D - Tema Interativo
Plataforma interativa de customizações do Liveness3DTheme() para dispositivos iOS
1. Guia Rápido
O Tema Interativo para personalização da biblioteca do OILiveness3D é uma plataforma essencial que permite a seleção de cores, bordas, arredondamento de bordas e sombreamento. Isso simplifica a geração de código, possibilitando a fácil implementação no seu Liveness 3D.
Aprenda a personalizar o Liveness 3D no iOS para integrar as propriedades customizadas em seu código de forma simples e ágil.
Siga os passos para interagir com o Tema Interativo.
Antes de começar
- Além disso, será necessário importar as fontes desejadas para o seu projeto para que elas sejam aplicadas corretamente.
Telas para customização
O Tema Interativo apresenta três telas de customização que orientam o usuário durante a execução do Liveness 3D:
- Na primeira tela, encontramos as instruções para a preparação do usuário, sendo o ponto inicial de interação com o Liveness 3D.
- A segunda tela é destinada à retentativa. Caso o usuário precise refazer a jornada, essa tela fornece diretrizes, incluindo um exemplo de foto ideal.
- A terceira tela consiste na tela de resultado. Nela, o usuário recebe a mensagem de conclusão do processo de Liveness.

Sequência de telas exibidas no iframe para customização.
Propriedades customizáveis
As propriedades destinadas à customização estão localizadas na segunda coluna do iframe. Nesta coluna, é possível encontrar o nome da propriedade (1) e sua respectiva descrição (2).

Coluna de propriedades customizáveis.
Para exportar o código das customizações
Passo 1: visualize o código
Após concluir todas as personalizações, é necessário clicar no botão "código" (1) para visualizar todas as modificações realizadas e, em seguida, exportá-las para incorporação no seu projeto.

Localização do botão "código" para exportação das customizações.
Passo 2: adicione o código gerado
Copie e cole no seu projeto o código de customização gerado pelo Tema Interativo e, se necessário, ajuste as propriedades conforme sua necessidade. Logo abaixo, na seção Propriedades customizáveis, você encontrará as propriedades ilustradas com imagens e identificadores, que facilitam o processo de configuração e ajustes.
Passo 3: importe as fontes
Adicione os arquivos no projeto e registre as fontes no Info.plist.

Como adicionar arquivos de fontes no projeto

Info.plist do seu projeto utilizando a propriedade "Fonts provided by application"
Passo 4: forneça o objeto de customização para o SDK
O objeto de customização (theme) que foi gerado deve ser passado como argumento para a struct Liveness3DUser, que possui dois parâmetros para tal:
defaultTheme: o tema padrão aplicado pelo SDK.lowLightTheme: o tema aplicado quando o SDK reconhece que o ambiente possui pouca luminosidade durante o processo de Liveness.
let liveness3DUser = Liveness3DUser(
appKey: "APP_KEYS",
environment: environment,
defaultTheme: theme,
lowLightTheme: theme
)
let viewController = Liveness3DViewController(
liveness3DUser: liveness3DUser,
delegate: delegate
)
present(viewController, animated: true)2. Tema Interativo - iOS
Use a plataforma para iniciar as customizações do Liveness 3D.
3. Propriedades customizáveis
Abaixo, estão mapeadas as propriedades de customização do Liveness3DTheme.
Guidance
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | guidanceCustomizationHeaderFont | UIFont? |
| 2 | guidanceCustomizationSubtextFont | UIFont? |
| 3 | guidanceCustomizationButtonBackgroundNormalColor | UIColor |
| 3 | guidanceCustomizationButtonBackgroundHighlightColor | UIColor |
| 3 | guidanceCustomizationButtonBackgroundDisabledColor | UIColor |
| 3 | guidanceCustomizationButtonTextNormalColor | UIColor |
| 3 | guidanceCustomizationButtonTextHighlightColor | UIColor |
| 3 | guidanceCustomizationButtonTextDisabledColor | UIColor |
| 3 | guidanceCustomizationButtonFont | UIFont? |
| 3 | guidanceCustomizationButtonBorderColor | UIColor |
| 3 | guidanceCustomizationButtonBorderWidth | Int32 |
| 3 | guidanceCustomizationButtonCornerRadius | Int32 |
Ready Screen
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | readyScreenCustomizationHeaderFont | UIFont? |
| 1 | readyScreenCustomizationHeaderTextColor | UIColor |
| 1 | readyScreenCustomizationTextBackgroundColor | UIColor? |
| 1 | readyScreenCustomizationTextBackgroundCornerRadius | Int32 |
| 2 | readyScreenCustomizationSubtextFont | UIFont? |
| 2 | readyScreenCustomizationSubtextTextColor | UIColor |
Retry Screen
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | retryScreenCustomizationHeaderFont | UIFont? |
| 1 | retryScreenCustomizationHeaderTextColor | UIColor |
| 2 | retryScreenCustomizationSubtextFont | UIFont? |
| 2 | retryScreenCustomizationSubtextTextColor | UIColor |
| 3 | retryScreenCustomizationImageBorderColor | UIColor |
| 3 | retryScreenCustomizationImageBorderWidth | Int32 |
| 3 | retryScreenCustomizationImageCornerRadius | Int32 |
Result Screen
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | resultScreenCustomizationAnimationRelativeScale | Float |
| 1 | resultScreenCustomizationAnimationStyle | ResultAnimationStyle |
| 2 | resultScreenCustomizationShowUploadProgressBar | Bool |
| 2 | resultScreenCustomizationUploadProgressFillColor | UIColor |
| 2 | resultScreenCustomizationUploadProgressTrackColor | UIColor |
| 3 | resultScreenCustomizationMessageFont | UIFont? |
| 3 | resultScreenCustomizationTextColor | UIColor |
Frame
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | frameCustomizationBorderWidth | Int32 |
| 1 | frameCustomizationBorderColor | UIColor |
| 1 | frameCustomizationBackgroundColor | UIColor |
| 1 | frameCustomizationCornerRadius | Int32 |
| 1 | frameCustomizationShadow | Liveness3DShadow? |
Oval
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | ovalCustomizationProgressColor1 | UIColor |
| 1 | ovalCustomizationProgressColor2 | UIColor |
| 1 | ovalCustomizationProgressStrokeWidth | Int32 |
| 1 | ovalCustomizationProgressRadialOffset | Int32 |
| 2 | ovalCustomizationStrokeColor | UIColor |
| 2 | ovalCustomizationStrokeWidth | Int32 |
Overlay
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | overlayCustomizationBackgroundColor | UIColor |
| 1 | overlayCustomizationBrandingImage | UIImage? |
| 1 | overlayCustomizationShowBrandingImage | Bool |
Feedback
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | feedbackCustomizationTextColor | UIColor |
| 1 | feedbackCustomizationTextFont | UIFont |
| 2 | feedbackCustomizationCornerRadius | Int32 |
| 2 | feedbackCustomizationBackgroundColor | UIColor |
| 2 | feedbackCustomizationShadow | Liveness3DShadow |
Cancel Button
| Identificador | Propriedade | Tipo |
|---|---|---|
| 1 | cancelButtonCustomizationCustomImage | UIImage? |
| 1 | cancelButtonCustomizationLocation | CancelButtonLocation |
4. Customização dos textos
Ready Screen
| Identificador | Texto padrão |
|---|---|
| readyHeader1 | "Vamos" |
| readyHeader2 | "começar!" |
| readyMessage1 | "Posicione seu rosto na moldura," |
| readyMessage2 | "se aproxime e toque em começar." |
| readyButton | "Começar" |
Retry Screen
| Identificador | Texto padrão |
|---|---|
| retryHeader | "Vamos tentar novamente?" |
| retrySubheader | "Siga o exemplo de foto ideal abaixo:" |
| retryYourPicture | "Não sorria" |
| retryIdealPicture | "Evite reflexos e iluminação extrema" |
| retryMessageSmile | "Precisamos de uma foto nítida" |
| retryMessageLightning | "Sua foto" |
| retryMessageContrast | "Foto ideal" |
| retryButton | "Tentar novamente" |
Result Screen
| Identificador | Texto padrão |
|---|---|
| resultUploadMessage | "Enviando" |
| resultSuccessMessage | "Tudo certo!" |
Feedback
| Identificador | Texto padrão |
|---|---|
| feedbackCenterFace | "Centralize seu rosto" |
| feedbackFaceNotFound | "Posicione seu rosto" |
| feedbackFaceNotLookingStraightAhead | "Olhe para frente" |
| feedbackFaceNotUpright | "Mantenha a cabeça reta" |
| feedbackHoldSteady | "Segure firme" |
| feedbackMovePhoneAway | "Afaste-se" |
| feedbackMovePhoneCloser | "Aproxime-se" |
| feedbackMovePhoneToEyeLevel | "Mantenha o telefone ao nível dos olhos" |
| feedbackUseEvenLighting | "Encontre um ambiente iluminado" |
| feedbackFrameYourFace | "Vamos começar" |
| feedbackPositionFaceStraightInOval | "Olhe para frente" |
| feedbackHoldSteady1 | "Segure firme por: 3" |
| feedbackHoldSteady2 | "Segure firme por: 2" |
| feedbackHoldSteady3 | "Segure firme por: 1" |
| feedbackRemoveDarkGlasses | "Remova seus óculos escuros" |
| feedbackNeutralExpression | "Olhe para a câmera sem sorrir" |
| feedbackConditionsTooBright | "Evite um ambiente muito iluminado" |
| feedbackBrightenYourEnvironment | "Encontre um ambiente bem iluminado" |
Updated 11 days ago
