Liveness 3D - Tema Interativo
Plataforma interativa de customizações do tema do Liveness 3D para Flutter
1. Guia Rápido
O Tema Interativo para personalização da biblioteca do Liveness 3D é 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 Flutter 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 a pasta de fontes do seu ambiente Android e iOS, nativamente arrastando e soltando seus arquivos .tff na pasta "assets/fonts" no Android, e no iOS registrando nos assets da aplicação.
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.
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).
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.
Passo 2: importe as fontes
Coloque os arquivos de fontes na pasta "assets res/fonts.xml" no Android ou registre nos assets caso seja iOS
Passo 3: inicie o builder do ThemeBuilder
e das fontes Liveness3dFonts
.
ThemeBuilder
e das fontes Liveness3dFonts
.Utilize o exemplo a seguir para iniciar as funções do tema com as propriedades desejadas.
ThemeBuilder _themeCustomization() {
return ThemeBuilder()
..guidanceCustomizationButtonBackgroundNormalColor = '#8e9334'
..ovalCustomizationStrokeColor = '#8e9334';
}
Liveness3dFonts _fontsCustomization() {
return Liveness3dFonts()
..guidanceCustomizationHeaderFont = 'Lobster'
..guidanceCustomizationSubtextFont = 'Lobster'
..readyScreenCustomizationHeaderFont = 'Lobster'
..guidanceCustomizationButtonFont = 'Lobster'
..feedbackCustomizationTextFont = 'Lobster';
}
Passo 4: identifique e implemente as propriedades
O objeto de cores inclui uma série de propriedades que podem ser customizadas, divididas em categorias como Guidance, Botões, Ready e Retry Screen, entre outras.
O código das propriedades customizadas também reflete essa série mencionada anteriormente. Identifique e implemente de acordo com as respetivas customizações.
2. Tema Interativo - Flutter
Use a plataforma para iniciar as customizações do Liveness 3D.
3. Propriedades customizáveis
Abaixo, estão mapeadas as propriedades para customização do objeto ThemeBuilder
.
Customizações de telas Liveness3D
Guidance
Atributo | Tipo | Descrição |
---|---|---|
guidanceCustomizationBackgroundColors | String? | Modifica a cor de fundo. |
guidanceCustomizationForegroundColor | String? | Modifica a cor de fundo quando estiver em primeiro plano. |
Botões
Atributo | Tipo | Descrição |
---|---|---|
guidanceCustomizationButtonTextNormalColor | String? | Modifica a cor do texto do botão na sua condição padrão. |
guidanceCustomizationButtonBackgroundNormalColor | String? | Modifica a cor de fundo do botão na sua condição padrão. |
guidanceCustomizationButtonTextHighlightColor | String? | Modifica a cor do texto do botão na sua condição de destaque. |
guidanceCustomizationButtonBackgroundHighlightColor | String? | Modifica a cor de fundo do botão na sua condição de destaque. |
guidanceCustomizationButtonTextDisabledColor | String? | Modifica a cor do texto do botão na sua condição de desabilitado. |
guidanceCustomizationButtonBackgroundDisabledColor | String? | Modifica a cor de fundo do botão na sua condição de desabilitado. |
guidanceCustomizationButtonBorderColor | String? | Modifica a cor da borda do botão. |
guidanceCustomizationButtonBorderWidth | int? | Modifica a largura da borda do botão. |
guidanceCustomizationButtonCornerRadius | int? | Modifica o tamanho do arredondamento das bordas do botão. |
Ready Screen
Atributo | Tipo | Descrição |
---|---|---|
guidanceCustomizationReadyScreenHeaderTextColor | String? | Modifica a cor da fonte do texto. |
guidanceCustomizationReadyScreenHeaderAttributedString | String? | Adiciona um texto para o header. |
guidanceCustomizationReadyScreenSubtextTextColor | String? | Modifica a cor da fonte do texto. |
guidanceCustomizationReadyScreenSubtextAttributedString | String? | Adiciona um texto para o subtext. |
guidanceCustomizationReadyScreenOvarFillColor | String? | Cor do oval. |
guidanceCustomizationReadyScreenTextBackgroundColor | String? | Modifica a cor de fundo. |
guidanceCustomizationReadyScreenTextBackgroundCornerRadius | int? | Modifica o tamanho do arredondamento das bordas. |
Retry Screen
Atributo | Tipo | Descrição |
---|---|---|
guidanceCustomizationRetryScreenHeaderTextColor | int? | Modifica a cor da fonte do header. |
guidanceCustomizationRetryScreenHeaderAttributedString | String | Adiciona uma mensagem personalizada no header. |
guidanceCustomizationRetryScreenSubtextTextColor | String? | Modifica a cor da fonte do subtext. |
guidanceCustomizationRetryScreenSubtextAttributedString | String? | Adiciona uma mensagem personalizada no subtext. |
guidanceCustomizationRetryScreenImageBorderColor | String? | Modifica a cor da borda do preview da imagem de retentativa. |
guidanceCustomizationRetryScreenImageBorderWidth | int? | Modifica a largura da borda do preview da imagem de retentativa. |
guidanceCustomizationRetryScreenImageCornerRadius | int? | Modifica o tamanho do arredondamento das bordas. |
guidanceCustomizationRetryScreenOvarStrokeColor | String? | Modifica a cor da borda do preview oval da imagem de retentativa. |
Result Screen Customization
Atributo | Tipo | Descrição |
---|---|---|
resultScreenCustomizationForegroundColor | String | Modifica a cor de fundo quando estiver em primeiro plano. |
resultScreenCustomizationBackgroundColors | String | Modifica a cor de fundo e caso receba duas cores diferentes cria um degradê. |
resultScreenCustomizationActivityIndicatorColor | String | Modifica a cor do activity indicator. |
resultScreenCustomizationCustomActivityIndicatorImage | String | Adiciona uma imagem customizada para o activity indicator. |
resultScreenCustomizationShowUploadProgressBar | String | Propriedade booleana que ativa a visualização da barra de progresso. |
resultScreenCustomizationUploadProgressFillColor | String | Modifica a cor do preenchimento da barra de progresso. |
resultScreenCustomizationUploadProgressTrackColor | String | Modifica a cor da barra de progresso. |
resultScreenCustomizationResultAnimationBackgroundColor | String | Modifica a cor de fundo da imagem que aparece após a animação finalizar. |
resultScreenCustomizationResultAnimationForegroundColor | String | Modifica a cor do icone que vai aparecer em primeiro plano após a animação finalizar. |
Oval Customization
Atributo | Tipo | Descrição |
---|---|---|
ovarCustomizationStrokeWidth | int? | Modifica a largura da borda da camada oval. |
ovarCustomizationStrokeColor | String? | Modifica a cor da borda da camada oval. |
ovarCustomizationProgressStrokeWidth | int? | Modifica a largura da borda do progresso da camada oval. |
ovarCustomizationProgressColor1 | String? | Modifica a cor da borda de progresso da camada oval. |
ovarCustomizationProgressColor2 | String | Modifica a cor da borda de progresso da camada oval. |
ovarCustomizationProgressRadialOffset | int? | Modifica o distânciamento da borda de progresso da camada oval. |
Frame Customization
Atributo | Tipo | Descrição |
---|---|---|
frameCustomizationBorderWidth | int? | Modifica a largura da borda do frame. |
frameCustomizationCornerRadius | int? | Modifica o tamanho do arredondamento das bordas do frame. |
frameCustomizationBorderColor | String? | Modifica a cor da borda do frame. |
frameCustomizationBackgroundColor | String? | Modifica a cor de fundo do frame. |
frameCustomizationElevation | int? | Sombra do frame. |
Overlay Customization
Atributo | Tipo | Descrição |
---|---|---|
overlayCustomizationBackgroundColor | String? | Modifica a cor de fundo da camada de overlay. |
overlayCustomizationBrandingImage | String? | Adiciona uma imagem na camada de overlay. |
Feedback Customization
Atributo | Tipo | Descrição |
---|---|---|
feedbackCustomizationCornerRadius | int? | Modifica o tamanho do arredondamento das bordas da barra. |
feedbackCustomizationBackgroundColor | String? | Modifica a cor de fundo da barra. |
feedbackCustomizationTextColor | String? | Modifica a cor do texto do feedback. |
Customização dos Textos
Da mesma forma que criamos um objeto, criamos para as fontes no 3D utilizando o TextsBuilder
, seguindo esse exemplo:
TextsBuilder _textsCustomization() {
return TextsBuilder()
..readyHeader1 = 'ready_header_1'
..readyHeader2 = 'ready_header_2'
..readyMessage1 = 'ready_message_1'
..readyMessage2 = 'ready_message_2'
..feedbackBrightenYourEnvironment = 'feedback_brighten_your_environment';
}
Ready Screen
Novo identificador | Antiga tag do arquivo XML |
---|---|
readyHeader1 | FaceTec_instructions_header_ready_1 |
readyHeader2 | FaceTec_instructions_header_ready_2 |
readyMessage1 | FaceTec_instructions_message_ready_1 |
readyMessage2 | FaceTec_instructions_message_ready_2 |
readyButton | FaceTec_action_im_ready |
Retry Screen
Novo identificador | Antiga tag do arquivo XML |
---|---|
retryHeader | FaceTec_retry_header |
retrySubheader | FaceTec_retry_subheader_message |
retryYourPicture | FaceTec_retry_instruction_message_1 |
retryIdealPicture | FaceTec_retry_instruction_message_2 |
retryMessageSmile | FaceTec_retry_instruction_message_3 |
retryMessageLighting | FaceTec_retry_your_image_label |
retryMessageContrast | FaceTec_retry_ideal_image_label |
retryButton | FaceTec_action_try_again |
Result Screen
Novo identificador | Antiga tag do arquivo XML |
---|---|
resultUploadMessage | FaceTec_result_facescan_upload_message |
resultSuccessMessage | FaceTec_result_success_message |
Feedback
Novo identificador | Antiga tag do arquivo XML |
---|---|
feedbackCenterFace | FaceTec_feedback_center_face |
feedbackFaceNotFound | FaceTec_feedback_face_not_found |
feedbackFaceNotLookingStraightAhead | FaceTec_feedback_face_not_looking_straight_ahead |
feedbackFaceNotUpright | FaceTec_feedback_face_not_upright |
feedbackHoldSteady | FaceTec_feedback_hold_steady |
feedbackMovePhoneAway | FaceTec_feedback_move_phone_away |
feedbackMovePhoneCloser | FaceTec_feedback_move_phone_closer |
feedbackMovePhoneToEyeLevel | FaceTec_feedback_move_phone_to_eye_level |
feedbackUseEvenLighting | FaceTec_feedback_use_even_lighting |
feedbackFrameYourFace | FaceTec_presession_frame_your_face |
feedbackPositionFaceStraightInOval | FaceTec_presession_position_face_straight_in_oval |
feedbackHoldSteady1 | FaceTec_presession_hold_steady_1 |
feedbackHoldSteady2 | FaceTec_presession_hold_steady_2 |
feedbackHoldSteady3 | FaceTec_presession_hold_steady_3 |
feedbackRemoveDarkGlasses | FaceTec_presession_remove_dark_glasses |
feedbackNeutralExpression | FaceTec_presession_neutral_expression |
feedbackConditionsTooBright | FaceTec_presession_conditions_too_bright |
feedbackBrightenYourEnvironment | FaceTec_presession_brighten_your_environment |
Updated 3 months ago