1. Guia Rápido

O Tema Interativo para personalização do SDK Android é 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 Android e 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

Primeiramente, é essencial seguir algumas etapas sequenciais.

• Uma delas envolve a atenção aos arquivos XML de cores, localizados na pasta "res/values/colors.xml" dentro do diretório Android. Se o arquivo existir, apenas edite; caso contrário, crie o arquivo.
• Além disso, será necessário importar as fontes desejadas para a pasta de fontes do seu ambiente Android, arrastando e soltando seus arquivos .tff na pasta "assets res/fonts.xml".

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

Passo 2: importe as fontes

Coloque os arquivos de fontes na pasta "assets res/fonts.xml".

Passo 3: inicie o Liveness3DTheme()

Utilize o exemplo a seguir para iniciar o builder() do tema com a classe Liveness3DTheme() do liveness3d-sdk:

val liveness3DTheme =
    Liveness3DTheme
        .Builder()
        // As propriedades selecionadas serão colocadas aqui.
        .build()

Passo 4: identifique e implemente as propriedades

O XML 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 respectivas customizações.

2. Tema Interativo

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

Customizações de telas Liveness3DTheme

Guidance

Botões

Ready Screen

Retry Screen

Result Screen Customization

Oval Customization

Frame Customization

Overlay Customization

Feedback Customization

Cancel Button

Exit Animation Style

Result Screen Message

Customização das fontes Liveness3DFontsKey

Exemplo de customização das fontes utilizadas nas telas do Liveness 3D por meio da chave Liveness3DFontsKey.

fun getFonts() = hashMapOf(
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_HEADER_FONT to br.com.oiti.liveness3d.R.font.ubuntu_bold,
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_SUBTEXT_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_BUTTON_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_READY_SCREEN_HEADER_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_READY_SCREEN_SUBTEXT_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_RETRY_SCREEN_HEADER_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.GUIDANCE_CUSTOMIZATION_RETRY_SCREEN_SUBTEXT_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.RESULT_SCREEN_CUSTOMIZATION_MESSAGE_FONT to "fonts/sixty.ttf",
    Liveness3DFontsKey.FEEDBACK_CUSTOMIZATION_TEXT_FONT to "fonts/sixty.ttf"
)

Customização dos textos Liveness3DTextKey

Nova forma de customização

Agora a activity Liveness3DActivity possui um novo parâmetro (PARAM_TEXTS) que recebe um HashMap tendo como chave o tipo Liveness3DTextKey e como valor uma string.
Dessa forma a customização de textos da FaceTec não é feita mais pelo arquivo strings.xml.

val texts = hashMapOf<Liveness3DTextKey, String>(
    Liveness3DTextKey.READY_HEADER_1 to "Vamos Iniciar",
    Liveness3DTextKey.READY_HEADER_2 to "a jornada",
    Liveness3DTextKey.READY_MESSAGE_1 to "Instruções de como fazer",
    Liveness3DTextKey.READY_MESSAGE_2 to "o desafio do Liveness 3D.",
)

startActivityForResult?.launch(Intent(this, Liveness3DActivity::class.java).apply {
    putExtra(Liveness3DActivity.PARAM_LIVENESS3D_USER, liveness3DUser)
    putExtra(Liveness3DActivity.PARAM_TEXTS, texts)
})

Novas tags

Ready Screen

Retry Screen

Result Screen

Feedback