Introdução

Os SDK's da plataforma Unico IDCloud tem como objetivo potencializar a segurança do seu negócio e dos seus clientes, permitindo inclusive personalizar a experiência de uso aplicando a identidade visual da sua marca. Os SDKs abstraem a complexidade de manipulação da câmera do dispositivo dos usuários e a captura de imagens (Selfie e documento), facilitando a vida do desenvolvedor e reduzindo o tempo de entrega do produto final. Outras vantagens:

• Prova de vida: Os SDK's são utilizados em conjunto com a capacidade de Prova de vida para garantir que o usuário esteja ao vivo no momento de captura da selfie;

• Precisão na captura de imagens: Os SDKs possuem recursos que auxiliam o usuário a obter fotos biometricamente válidas, reduzindo o drop das imagens quando comparados a captura realizada pelas câmeras padrões dos dispositivos. São adicionados SmartFrames, “elementos chave“ que se ajustam automaticamente à silhueta e proporção da tela do usuário permitindo uma melhor captura da imagem;

• Segurança reforçada: Recursos de criptografia e segurança contra injection de imagens, possuindo também funcionalidades que previnem fraudes adaptadas a diferentes modos de câmera. Camadas de segurança que funcionam de forma complementar, tanto a nível da aplicação quanto em relação aos dados que são trafegados entre os SDKs e o backend. O SDK também inclui ofuscação de código, bloqueio de emulador e checagem de bundle do aplicativo que a está executando.

A captura das imagens por meio dos SDKs é apenas a primeira parte de sua jornada. Sendo assim, é de extrema importância que entenda os conceitos básicos e o funcionamento das APIs do motor biométrico. Para mais informações, veja sobre a API REST do by Client.

Diagrama de Funcionamento

O SDK (Client-side) é responsável por simplificar sua integração com a plataforma Unico IDCloud, absorvendo toda a complexidade da manipulação da câmera e captura de imagens.

Se a captura for feita com sucesso, o SDK retorna um objeto que deve ser enviado para a API do motor biométrico, completando assim a validação biométrica, conforme diagrama exemplificado abaixo:

Requisitos suportados por cada Client SDK

A seguir, informações e requisitos necessários, oficialmente suportados por cada Client SDK da Unico:

Versionamento dos SDKs

Os SDKs da plataforma Unico IDCloud possuem um versionamento semântico, sendo assim, há numeração de versão "MAJOR.MINOR.PATCH", descrita da seguinte forma:

• Versão Maior(MAJOR): Quando fizer mudanças incompatíveis na API;

• Versão Menor(MINOR): Quando adicionar funcionalidades mantendo compatibilidade;

• Versão de Correção (PATCH): Quando corrigir falhas mantendo compatibilidade.

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.

Este guia foi elaborado para ajudá-lo a implementar o SDK Android de forma rápida e fácil. Abaixo veja o passo a passo de todo o processo de integração. Após isso, caso deseje personalizar a experiência, não deixe de ver a seção Personalização Android.

Inicializar o SDK

Crie uma instância do builder (Gerado através da interface IAcessoBioBuilder), fornecendo como parâmetro o contexto e ambiente em questão e a implementação da classe AcessoBioListener.

A implementação dessa classe é bem simples e pode ser feita com poucas linhas de código. Tudo que precisa fazer é instanciar o builder informando o contexto em questão e sobrescrever os métodos de callback com as lógicas de negócio de sua aplicação:

public class MainActivity extends AppCompatActivity {

    private AcessoBioListener callback = new AcessoBioListener() {
        @Override
        public void onErrorAcessoBio(ErrorBio errorBio) { }

        @Override
        public void onUserClosedCameraManually() { }

        @Override
        public void onSystemClosedCameraTimeoutSession() { }

        @Override
        public void onSystemChangedTypeCameraTimeoutFaceInference() { }
    };

    private IAcessoBioBuilder acessoBioBuilder = new AcessoBio(this, callback);
}

internal class MainActivity : AppCompatActivity() {

    private val callback = object : AcessoBioListener {
        override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
    
        override fun onUserClosedCameraManually() { }
    
        override fun onSystemClosedCameraTimeoutSession() { }
    
        override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
    }

    private val acessoBioBuilder: IAcessoBioBuilder = AcessoBio(this, callback)
}

Configuração de ambientes

Configure o ambiente que será utilizado na execução da SDK. Utilize o enumerado Environment que contém os seguintes enumerados:

• Environment.PROD: para ambiente de Produção;

• Environment.UAT: para ambiente de Homologação.

Veja como implementar no exemplo abaixo:

acessoBioBuilder.setEnvironment(Environment.UAT);

acessoBioBuilder.setEnvironment(Environment.UAT);

Implementar as funções de callback

Note que, o trabalho de implementação da classe AcessoBioListener é, em grande parte, a configuração dos métodos de callback. Cada método é chamado em uma situação específica de retorno do SDK.

Basta sobrescrever os métodos exemplificados no passo anterior com as lógicas de negócio de sua aplicação.

Este método é invocado sempre que qualquer erro de implementação ocorrer ao utilizar algum de nossos métodos:

Configurar modo de câmera

O SDK tem configurado e habilitado por padrão o enquadramento inteligente e a captura automática. Em função disso, deve-se configurar o modo de câmera no seu builder da seguinte forma:

UnicoCheckCamera unicoCheckCamera = acessoBioBuilder
    .setAutoCapture(true)
    .setSmartFrame(true)
    .build();

val unicoCheckCamera: UnicoCheckCamera = acessoBioBuilder
    .setAutoCapture(true)
    .setSmartFrame(true)
    .build()

Implementar listeners para eventos da câmera

O método de abertura da câmera, que é chamado na próxima etapa, precisa saber o que fazer ao conseguir capturar uma imagem com sucesso ou ao ocorrer algum erro no processo. É necessário informar "o que fazer" ao método de abertura da câmera através da implantação de listeners que são chamados em situações de sucesso ou erro.

Através da configuração dos listeners, você pode especificar o que acontece em seu App em situações de erro (Método onErrorSelfie) ou sucesso (Método onSuccessSelfie) na captura de imagens.

Para a configuração dos listeners, é necessário implementar:

iAcessoBioSelfie cameraListener = new iAcessoBioSelfie() {
    @Override
    public void onSuccessSelfie(ResultCamera result) { }

    @Override
    public void onErrorSelfie(ErrorBio errorBio) { }
};

unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
        cameraOpener.open(cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
});

val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie {
    override fun onSuccessSelfie(result: ResultCamera?) {}

    override fun onErrorSelfie(errorBio: ErrorBio?) {}
}

unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        cameraOpener?.open(cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
})

Preparar e abrir câmera

Para seguir com a abertura da câmera, primeiro é necessário prepará-la utilizando o método prepareCamera. Este método recebe como parâmetro a implementação da classe CameraListener, a classe ou o JSON com as credenciais, gerado nessa etapa.

Quando a câmera estiver preparada, é disparado o evento onCameraReady, que recebe como parâmetro um objeto do tipo UnicoCheckCameraOpener.Camera.

É necessário sobrescrever este método, efetuando a abertura da câmera com o objeto recebido através do método open(). O método open() deve receber como parâmetro os listeners configurados nos passos acima.

Método onSucessSelfie

Ao efetuar uma captura de imagem com sucesso, este método é invocado e retorna um objeto do tipo ResultCamera que é utilizado posteriormente na chamada das APIs REST:

public void onSuccessSelfie(ResultCamera result) { }

O objeto ResultCamera retorna 2 atributos: base64 e encrypted:

• O atributo base64 pode ser utilizado se quiser exibir uma prévia da imagem em seu app;

• O atributo encrypted deve ser enviado na chamada das APIs REST do by Client.

Método onErrorSelfie

Ao ocorrer algum erro na captura de imagem, este método é invocado e retorna um objeto do tipo ErrorBio:

public void onErrorSelfie(ErrorBio errorBio) { }

Realize um requisição POST na API REST do by Client

A captura das imagens é apenas a primeira parte da jornada. Após capturar a imagem, é necessário enviar o encrypted gerado pelo SDK para as APIs REST do by Client. Saiba mais na seção CreateProcess do by Client.

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.

É essencial que todos os clientes mantenham uma rotina de atualização do SDK, uma vez que novas formas de ataque são desenvolvidas a todo momento. A melhor forma de ter seu negócio protegido contra novos formatos de fraudes de Injection e Liveness é usar a versão mais atualizada do SDK da Unico.

É responsabilidade do cliente manter uma rotina saudável de atualização da SDK, garantindo a versão mínima para o bom funcionamento das nossas soluções em suas operações. Assim como é responsabilidade da Unico disponibilizar versões atualizadas, em relação às ameaças que surgem no mercado, e manter nossos clientes informados sobre o tema. Tendo isso em mente, a Unico criou uma Política de atualização do SDK.

Por que temos uma política de atualizações do SDK?

Com o SDK desatualizado, nossos clientes estão vulneráveis a ataques de fraudadores. Considerando que a Unico preza pela máxima segurança de seus clientes, além da urgência do tema e necessidade de um processo ágil de atualizações, criou-se a política de atualização do SDK a fim de salvaguardar nossos clientes das mais novas fraudes que aparecem constantemente no mercado. A única forma de estar seguro é estar atualizado.

Categorias de Atualizações

A Unico categoriza todas as atualizações de SDK entre Crítica e Não-crítica, baseados na criticidade das fraudes que bloqueamos com a nova versão.

• Atualizações Críticas: São atualizações que visam proteger nossos clientes contra fraudes e ataques recentes no mercado. Elas precisam ser implementadas em até 5 (cinco) dias corridos, tendo em vista a ameaça real que a operação está suscetível. A partir daí, não daremos mais suporte à versões anteriores. Na prática, o cliente que entrar em contato conosco com uma versão anterior a última deverá obrigatoriamente atualizar o SDK para que possamos atendê-lo.

• Atualizações Não-Críticas: São atualizações mais simples, de melhoria da tecnologia. Elas podem ser implementadas em até 60 (sessenta) dias corridos. Vale reforçar que, quanto mais atual a versão, mais chances de evitar bugs e erros. Por isso recomendamos que seja feita a atualização o mais rápido possível. Após este período, não daremos mais suporte técnico e o cliente precisa atualizar seu SDK para que possamos atuar nos casos.

Nós identificamos as atualizações como críticas no Release Notes com uma tag logo abaixo da versão, conforme exemplo abaixo:

Estes períodos valem para todos os clientes da Unico, independentemente da capacidade utilizada.

Pode acontecer quebra de contrato de API por conta dessa política?

Onde vejo quais são as novidades das versões?

Como faço para saber quando sai uma nova versão?

• Para atualizações críticas: enviaremos um e-mail assim que a nova versão estiver disponível, com reforço via time de Customer Success. Informando a urgência do tema e o tempo de 5 (cinco) dias corridos para atualização.

• Para atualizações Não-críticas: para evitar sobrecarga dos times dos clientes, enviaremos um e-mail mensal com o resumo das atualizações não-críticas. Informando os principais pontos de mudança e o tempo de 60 (sessenta) dias corridos para atualização.

Este guia foi elaborado para ajudá-lo a implementar o SDK Android de forma rápida e fácil. Abaixo veja o passo a passo de todo o processo de integração. Após isso, caso deseje personalizar a experiência, não deixe de ver a seção Personalização Android.

Frames de documentos disponíveis

Neste modo de câmera, existe um frame de captura para auxiliar o usuário a posicionar o documento corretamente. Após posicionar o documento corretamente, o usuário deve clicar no botão para realizar a captura da foto do documento.

Neste modo de câmera é possivel capturar os documentos:

• CPF: Captura da frente do CPF;

• CNH: Captura da CNH aberta;

• CNH frente: Captura da frente da CNH;

• CNH verso: Captura do verso da CNH;

• RG frente: Captura da frente do RG;

• RG verso: Captura do verso do RG;

• Outros: Captura de qualquer outro documento.

Inicializar o SDK

Crie uma instância do builder (Gerado através da interface IAcessoBioBuilder), fornecendo como parâmetro o contexto em questão e a implementação da classe AcessoBioListener.

A implementação dessa classe é bem simples e pode ser feita com poucas linhas de código. Tudo que precisa fazer é instanciar o builder informando o contexto em questão e sobrescrever os métodos de callback com as lógicas de negócio de sua aplicação:

public class MainActivity extends AppCompatActivity {

    private AcessoBioListener callback = new AcessoBioListener() {
        @Override
        public void onErrorAcessoBio(ErrorBio errorBio) { }

        @Override
        public void onUserClosedCameraManually() { }

        @Override
        public void onSystemClosedCameraTimeoutSession() { }

        @Override
        public void onSystemChangedTypeCameraTimeoutFaceInference() { }
    };

    private IAcessoBioBuilder acessoBioBuilder = new AcessoBio(this, callback);
}

internal class MainActivity : AppCompatActivity() {

    private val callback = object : AcessoBioListener {
        override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
    
        override fun onUserClosedCameraManually() { }
    
        override fun onSystemClosedCameraTimeoutSession() { }
    
        override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
    }

    private val acessoBioBuilder: IAcessoBioBuilder = AcessoBio(this, callback)
}

Implementar as funções de callback

Note que, o trabalho de implementação da classe AcessoBioListener é, em grande parte, a configuração dos métodos de callback. Cada método é chamado em uma situação específica de retorno do SDK.

Basta sobrescrever os métodos exemplificados no passo anterior com as lógicas de negócio de sua aplicação:

Implementar listeners para eventos da câmera

O método de abertura da câmera, que é chamado na próxima etapa, precisa saber o que fazer ao conseguir capturar uma imagem com sucesso ou ao ocorrer algum erro no processo. É necessário informar "o que fazer" ao método de abertura da câmera através da implantação de listeners que são chamados em situações de sucesso ou erro.

Através da configuração dos listeners, você pode especificar o que acontece em seu App em situações de erro (Método onErrorDocument) ou sucesso (Método onSuccessDocument) na captura de imagens.

O exemplo abaixo ilustra a configuração dos listeners, build e abertura da câmera:

iAcessoBioDocument cameraListener = new iAcessoBioDocument() {
    @Override
    public void onSuccessDocument(ResultCamera result) { }

    @Override
    public void onErrorDocument(ErrorBio errorBio) { }
};

unicoCheckCamera.prepareDocumentCamera(unicoConfig, new DocumentCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
        cameraOpener.open(DocumentType.CNH, cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
});

val cameraListener: iAcessoBioDocument = object : iAcessoBioDocument {
    override fun onSuccessDocument(result: ResultCamera?) {}

    override fun onErrorDocument(errorBio: ErrorBio?) {}
}

unicoCheckCamera.prepareDocumentCamera(unicoConfig, object : DocumentCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
        cameraOpener?.open(DocumentType.CNH, cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
})

Preparar e abrir câmera

É necessário criar uma instância do builder através do método build(). Este método é disponibilizado através do objeto gerado com a interface IAcessoBioBuilder e classe AcessoBio:

UnicoCheckCamera unicoCheckCamera = acessoBioBuilder.build();  

val unicoCheckCamera = acessoBioBuilder.build()

O próximo passo é preparar a câmera utilizando o método prepareDocumentCamera() com o objeto retornado pelo builder (Nomeado como UnicoCheckCamera no exemplo acima).

O método prepareDocumentCamera() gera um objeto do tipo UnicoCheckCameraOpener.Document, que é utilizado para abrir a câmera com seu método open(), recebendo os parâmetros tipo de documento a ser capturado, sendo eles:

Método onSucessDocument

Ao efetuar uma captura de imagem com sucesso, este método é invocado e retorna um objeto do tipo ResultCamera que é utilizado posteriormente na chamada das APIs REST:

public void onSuccessDocument(ResultCamera result) { }

O objeto ResultCamera retorna 2 atributos: base64 e encrypted:

• O atributo base64 pode ser utilizado se quiser exibir uma prévia da imagem em seu app;

• Tanto o atributo encrypted quanto o atributo base64 podem ser enviados na chamada das APIs REST do by Client.

Método onErrorDocument

Ao ocorrer algum erro na captura de imagem, este método é invocado e retorna um objeto do tipo ErrorBio:

public void onErrorDocument(ErrorBio errorBio) { }

Realize um requisição POST na API REST do by Client

A captura das imagens é apenas a primeira parte da jornada. Após capturar a imagem, é necessário enviar o base64 gerado pelo SDK para as APIs REST do by Client. Saiba mais na seção CreateProcess do by Client.

Dúvidas?​

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.

Pré-requisitos do ambiente de desenvolvimento

É necessário que seu ambiente de desenvolvimento esteja de acordo com os seguintes pré-requisitos:

Dispositivos compatíveis

O SDK Android é compatível com a grande maioria dos dispositivos que possuam Android 5.0 (API de nível 21) ou versões superiores.

A tabela a seguir lista os dispositivos testados em laboratório, além da disponibilidade das extensões do fornecedor/fabricante. Algumas extensões listadas podem estar sujeitas as API ou SKUs específicos do fabricante. Clique abaixo para ver os dispositivos testados:

Instalando o SDK Android

Para implementar o SDK Android da plataforma Unico IDCloud ao seu aplicativo Android, siga o passo a passo listado abaixo:

Ofuscação de código

O ofuscamento é um processo de transformar o bytecode em uma forma menos legível por humanos, dificultando assim a engenharia reversa.

Esse processo consiste em remover informações relacionadas a depuração como tabelas de variáveis, número de linhas e renomear os pacotes, classes e métodos.

Ao embarcar a SDK Adroid na aplicação podem ocorrer falhas.

Ofuscação via DexGuard

Quando o ofuscamento foi realizado via DexGuard, ao ocorrer a falha utilize as regras:

Ofuscação via ProGuard

Quando o ofuscamento foi realizado via ProGuard, ao ocorrer a falha utilize as regras:

Atualização do SDK - versão 4.3.x

Altere o repositório Maven:

Altere o repositório Maven para o novo repositório no arquivo build.gradle do projeto.

A implementação era feita da seguinte forma:

Agora deve ser atualizado para o novo repositório:

Alterar a dependência do SDK

Altere a dependência do SDK para a nova dependência no arquivo app/build.gradle do projeto.

A implementação era feita da seguinte forma:

Agora deve ser atualizado para a nova dependência:

Objeto ErrorBio

Este objeto é retornado sempre que ocorre um erro no SDK Android.

Métodos disponíveis

É disponibilizado a seguir a lista de possíveis códigos de erro do SDK Android:

O SDK Android permite que algumas personalizações sejam feitas. Abaixo veja todas as personalizações possíveis para este SDK.

Personalizar idioma

É possível configurar a experiência das mensagens informativas dos frames de captura alterando seu idioma. Utilize o enumerado LocaleTypes que contém os seguintes valores:

• LocaleTypes.PT_BR: para Português(Brasil);

• LocaleTypes.ES_MX: para Espanhol(México);

• LocaleTypes.ES_ES: para Espanhol(Espanha);

• LocaleTypes.EN_US: para Inglês(EUA).

Veja como implementar no exemplo abaixo:

Personalizar experiência do processo de captura

Personalizar experiência de captura da Selfie

Esta é uma etapa opcional, porém muito recomendada para que o processo de captura tenha a identidade visual da sua empresa.

É possível customizar alguns objetos do frame de acordo com o modo de câmera utilizado, através do método setTheme().

Todos os métodos estão disponíveis abaixo:

Também é possível realizar personalizações de forma estática, no seu arquivo colors.xml adicione o seguinte código:

Abaixo, confira a especificação de campos da personalização:

Personalizar experiência de captura do documento

Esta é uma etapa opcional, porém muito recomendada para que o processo de captura tenha a

Esta é uma etapa opcional, porém muito recomendada para que o processo de captura tenha a identidade visual da sua empresa.

É possível customizar alguns objetos do frame de acordo com o modo de câmera utilizado, através do método setTheme().

Todos os métodos estão disponíveis abaixo:

Também é possível realizar personalizações de forma estática, no seu arquivo colors.xml adicione o seguinte código:

Abaixo, confira a especificação de campos da personalização:

Versão 5.26.0​ - 21/11/2024

• Atualização do SDK e server do Liveness com interação.

Versão 5.25.0​ - 04/11/2024

• Atualização do SDK e server do Liveness com interação.

Versão 5.24.0​ - 17/10/2024

• Atualização do SDK e server do Liveness com interação;

• Melhorias internas no produto, sem impacto externo.

Versão 5.23.1​ - 09/10/2024

Correção na câmera de documento, onde em alguns cenários ocorria um crash após a captura.

Versão 5.23.0​ - 04/10/2024

• Atualização do SDK e server do Liveness com interação;

• Melhorias internas no produto, sem impacto externo;

Versão 5.22.0 - 19/09/2024

• Atualização do SDK e server do Liveness com interação;

• Melhorias internas no produto, sem impacto externo.

Versão 5.21.1​ - 29/08/2024

• Correção na resposta das requisições internas da sdk, onde em alguns casos quando não havia internet, o callback de erro não era devolvido e mantinha o usuário preso na tela.

Versão 5.21.0​ - 28/08/2024

• Melhorias internas no produto, sem impacto externo.

Versão 5.20.0 - 20/08/2024

• Melhorias internas no produto, sem impacto externo.

Versão 5.19.2 - 13/08/2024

• Correção de localização setLocale() na captura com Liveness interativo.

Versão 5.19.1​ - 08/08/2024

• Correção de erros internos que não afetam a experiência do usuário final.

Versão 5.19.0​ - 07/08/2024

• Melhorias internas de produto. Essas melhorias não afetam diretamente a experiência do usuário final, mantendo a interface e funcionalidades externas inalteradas.

Versão 5.18.0​ - 18/07/2024

• Melhorias de segurança em nosso Liveness;

• A partir de agora, os desenvolvedores serão notificados em tempo real durante o desenvolvimento se a versão utilizada não estiver em conformidade com as políticas de atualização da Unico. Em casos de dúvidas, contacte o seu CSM;

• A partir de agora, é possível definir o ambiente da SDK pela própria API pública no método setEnvironment() . Em casos de dúvidas, contate o seu CSM.

Versão 5.17.0​ - 29/06/2024

• Atualização do SDK e server do Smartlive com interação.

Versão 5.16.0​ - 18/06/2024

• Melhorias nos algoritmos de comunicação entre o clientside e serverside unico.

Versão 5.15.1​ - 12/06/2024

• Correção do erro current host is not registred em ambiente de homologação.

Versão 5.15.0​ - 07/06/2024

• Melhorias internas no produto, sem impacto externo.

Versão 5.14.3​ - 04/06/2024

• Atualização do SDK e server do Smartlive com interação;

• Melhorias nas verificações de injeção de vídeo recentemente adicionadas no lado do dispositivo e no lado do servidor para mitigar ameaças de IA generativa.

Versão 5.14.1​ - 30/05/2024

• Atualização do SDK e server do Smartlive com interação;

• Melhorias nas verificações de injeção de vídeo recentemente adicionadas no lado do dispositivo e no lado do servidor para mitigar ameaças de IA generativa.

Versão 5.14.0​ - 06/05/2024

• Melhorias e correções na inicialização da SDK, evitando a perda de 1.5% das sessões.

Versão 5.13.0​ - 29/04/2024

• Atualização do SDK e server do Smartlive com interação.

Versão 5.12.0​ - 22/04/2024

• Novas funcionalidades que melhoram a experiência de captura no Liveness Interativo.

Versão 5.11.0​ - 09/04/2024

• Melhorias nas verificações de injeção de vídeo recentemente adicionadas no lado do dispositivo e no lado do servidor para mitigar ameaças de IA generativa.

Versão 5.10.4​ - 04/04/2024

• Correção no botão de fechar na captura de liveness interativo, em alguns cenários uma tela de loading pode aparecer por tempo indeterminado.

Versão 5.10.3​ - 03/04/2024

• Correção no ciclo de vida da captura, em cenários onde a tela é encerrada antes do callback de sucesso ou erro.

Versão 5.10.2​ - 28/03/2024

• Correção na geolocalização, em cenários onde a aplicação pode parar quando for desabilitada.

Versão 5.10.1​ - 22/03/2024

• Correção na compatibilidade em estilos predefinidos, causando conflitos entre <attr ... />.

Versão 5.10.0​ - 19/03/2024

• Melhorias nas verificações de injeção de vídeo recentemente adicionadas no lado do dispositivo e no lado do servidor para mitigar ameaças de IA generativa;

• Nova funcionalidade de captura para garantir segurança eficaz;

• Atualização do SDK e server do Smartlive com interação;

• Fix camera traseira no modelo Multilaser M8.

Versão 5.9.0​ - 23/02/2024

• Habilitamos a customização da cor da barra de progresso através do método opcional setColorProgressBar();

• Habilitamos a customização dos textos da UI do liveness interativo via configuração remota;

• Habilitação a customização do logo abaixo do frame de captura do smartlive com interação.

Versão 5.8.0​ - 26/01/2024

• Atualização do SDK e server do Smartlive com interação;

• Melhoria interna no produto, sem impacto externo.

Versão 5.7.0​ - 11/01/2024

• Melhorias nos registros de log do SDK;

• Melhoria interna no produto, sem impacto externo.

Versão 5.6.1​ - 20/12/2023

• Correção do problema relacionado a orquestração thread's de retorno ao cliente que impactava a captura biométrica quando fluxo de retentativa habilitado.

Versão 5.6.0​ - 13/12/2023

Essa versão visa proporcionar uma experiência mais estável e eficiente. Requer apenas atualização da SDK.

• Disponibilizado código e descrição do erro retornado pelo callback onCameraFailed, facilitando seu monitoramento e mapeamento;

• Definição automática de ambientes de produção e homologação no SDK;

• Otimização no fluxo de gerar JWT melhorando a performance.

Versão 5.5.2​ - 12/12/2023

• Melhoria no fluxo de autenticação, reduzindo falhas na autenticação de dispositivos com configurações específicas no Sistema Operacional. Essa modificação visa proporcionar uma experiência mais estável e eficiente. Importante destacar que essa melhoria requer apenas a atualização da SDK para que os benefícios sejam integralmente aplicados.

Versão 5.5.1​ - 23/11/2023

• Atualização do SDK e server do Smartlive com interação.

Versão 5.4.0​ - 08/11/2023

• Melhoria internas no produto, sem impacto externo.

Versão 5.3.0​ - 27/10/2023

• Melhorias internas;

• Ao receber uma config inválida o erro é retornado pelo callback onCameraFailed e não mais pelo exception do UnicoCheckException.

• Hotfix: Câmera de Documento com Liveness habilitado;

• Hotfix: Modo escuro não respeita as cores customizadas em alguns dispositivos Xiaomi.

Versão 5.2.0​ - 16/10/2023

• Disponibilizar o novo fluxo de captura e retentativas quando usado o Liveness com Interação (entrar em contato com a único caso queira habilitar essa nova funcionalidade);

• Lançar erro 73800 caso haja falha na captura usando o fluxo de retentativa;

• Lançar erro 73100 caso haja falha de conexão com internet durante uma requisição;

• Removido o timeout do fluxo de captura usando Livenes com Interação.

Versão 5.1.5​ - 28/09/2023

• Hotfix: Corrigido callbacks internos como opcionais prevenindo possíveis erros relacionados a propriedades não inicializadas;

• Hotfix: Reforçado a clareza das mensagens de erro para desenvolvedores, em especial quando há ausência da implementação da AcessoBioListener, tornando mais intuitivo o processo de correção;

• Hotfix: Alterado as regras de ofuscação para garantir que a classe UnicoCheckException não seja ofuscada e os erros sejam exibidos corretamente no console e nos logs;

• Hotfix: Otimizado a inicialização do objeto bioConfig evitando erros internos.

Versão 5.1.4​ - 14/09/2023

• Hotfix: Corrigido um problema na configuração do SDK através do arquivo JSON.

Versão 5.1.3​ - 31/08/2023

• Hotfix: Corrigido erro de caractere afetando build;

• Hotfix: Modo baixa luminosidade não altera a cor dos textos.

Versão 5.1.2​ - 17/08/2023

• Hotfix: Aplicação não respondendo, ARN;

• Hotfix: Modo alta luminosidade não altera a cor dos texto;

• Hotfix: Erro internal exception.

Versão 5.1.1​ - 30/07/2023

• Atualização do SDK client e server do Smartlive com interação.

Versão 5.1.0​ - 26/07/2023

• Melhoria de segurança na comunicação da SDK.

Versão 5.0.1​ - 14/07/2023

• Hotfix: Timeout na câmera traseira.

Versão 5.0.0​ - 21/06/2023

• Atualização do SDK client e server do Smartlive com interação;

• Atualização das mensagens do Smartlive com interação;

• Atualização da biblioteca de CameraX

• Adicionado timeout na câmera de liveness com interação;

• Hotfix: Câmera de documento.

Versão 4.4.1​ - 30/05/2023

• Hotfix: compatibilidade com Android 8.0.

Versão 4.4.0​ - 04/05/2023

• Melhoria de compatibilidade com a ferramenta de ofuscação;

• Melhoria de segurança na comunicação da SDK;

• Nova URL do repositório para download do SDK;

• Alteração do nome do SDK de com.github.acesso-io:acessobio-android para io.unico:capture;

• Suporte para o Kotlin a partir da versão 1.5.

Versão 4.2.12​ - 28/03/2023

• Atualização do SDK client e server do Smartlive com interação.

Versão 4.2.11​ - 24/03/2023

• Hotfix: Suporte ao tema dark.

Versão 4.2.10​ - 07/03/2023

• Hotfix: Compatibilidade ofuscação.

Versão 4.2.9​ - 23/02/2023

• Hotfix: Geolocalização em casos de endereço nulo;

• Hotfix: Tempo de expiração da câmera de documentos;

• Hotfix: Implementação de projeto com sentry.

Versão 4.2.8​ - 14/02/2023

• Hotfix: Abertura de camera traseira;

• Atualização da versão do modo de câmera de selfie com prova de vida da FaceTec.

Versão 4.2.7​ - 13/01/2023

• Feat: segurança no changelog;

• Feat: Atualização da SDK e server do Smartlive com interação.

• Fix: Suporte a uso do modo de câmera com captura automática em tablets;

• Fix: Conflito com sentry.

Versão 4.2.6​ - 22/11/2022

• Atualização da SDK e server do Smartlive com interação;

• Coleta de dados de uso, geolocalização e dispositivo (Os dados coletados são usados para garantir a segurança do processo e melhorar a experiência do usuário);

• Correção do bug para abrir a câmera em dispositivos com Android 6.0.1.

Versão 4.2.5​ - 10/11/2022

• Hotfix: Prefixo da url.

Versão 4.2.1​ - 06/09/2022

• Hotfix: Contorno da silhueta na cor branca.

Versão 4.2.0​ - 12/08/2022

• Uma nova camada de segurança;

• Atualização da versão do modo de câmera de selfie com prova de vida da FaceTec.

Versão 4.1.5​ - 22/07/2022

• Hotfix: Melhoria da lentidão na main thread;

• Hotfix: Tratamento dos retornos de erro onBackPressed, bitmap e no available camera.

Versão 4.1.4​ - 22/07/2022

• Novo incremento de segurança;

• Ajuste na resolução das imagens;

• Hotfix: Ajuste no uso de captura de documentos usando uma APIKey com Smartlive ativo habilitado;

• Hotfix: Ajustes na configuração de timeout da câmera de documentos.

Versão 4.1.3​ - 28/06/2022

• Hotfix: Ajuste no frame de captura de documentos genéricos;

• Hotfix: Correção de nomenclaturas que causavam conflito de themes;

• Hotfix: Melhoria na coleta de logs de erro.

Versão 4.1.0​ - 14/06/2022

• Indicador de atividade agora possui mesma cor que a mensagem na customização;

• Possibilidade de executar os métodos prepareSelfieCamera e prepareDocumentCamera sem o arquivo json, utilizando uma interface do tipo AcessoBioConfigDataSource.

Versão 4.0.16​ - 07/06/2022

• Hotfix: ajuste no lifecycle do frame de captura com interação.

Versão 4.0.15​ - 17/05/2022

• Melhoria da resolução da imagem gerada pelo modo de câmera de selfie com prova de vida da FaceTec para celulares de qualidade média/alta;

• Atualização do google play services ML Kit face detection para a versão 17.0.1.

Versão 4.0.14​ - 26/04/2022

• Atualização da versão do modo de câmera de selfie com prova de vida da FaceTec;

• Remoção de pedidos de permissões que não estavam sendo usados.

Versão 4.0.13​ - 07/04/2022

• Ajuste no tema padrão para o modo de baixa luminosidade modo de câmera de selfie com prova de vida da FaceTec.

Versão 4.0.12​ - 05/04/2022

• Customização do botão de fechar camera;

• Correções de erros na customização de sucesso.

Versão 4.0.11​ - 30/03/2022

• Ajuste para otimizar performance;

• Ajuste no seletor de câmera para dispositivos com múltiplas câmeras.

Versão 4.0.10​ - 25/03/2022

• Ajuste nas configurações que geram o objeto encriptado unico;

• Correções em configuração de Temas;

• Resolução de conflitos com bugfender.

Versão 4.0.9​ - 21/03/2022

• Downgrade do Kotlin para 1.4.0;

• Ajuste ao abrir a câmera pela segunda vez.

Versão 4.0.8​ - 11/03/2022

• Correção no encrypted.

Versão 4.0.7​ - 07/03/2022

• Ajuste de dependencias para tornar as bibliotecas do SDK Android compativeis com minCompileSdk 30.

Versão 4.0.6​ - 01/03/2022

• Adicionada compatibilidade com java 8;

• Adicionado frames de captura de CNH frente e CNH verso.

Versão 4.0.5​ - 17/02/2022

• Correção de erro no jitpack.

Versão 4.0.4​ - 16/02/2022

• Update da biblioteca GSON para versão 2.8.9;

• Ajuste no módulo de abertura de câmera.

Versão 4.0.3​ - 10/02/2022

• Foi corrigido o bug no módulo de abertura da câmera de documentos.

Versão 4.0.2​ - 09/02/2022

• Foi corrigido o bug que deixa o debug lento ao utilizar o SDK Android.

Versão 4.0.1​ - 04/02/2022

• Foi corrigido o bug referente a: request prepare camera.

Versão 4.0.0​ - 02/02/2022

• A partir de agora, o SDK Android conta com a funcionalidade de Prova de Vida. Para atualizar essa nova versão do SDK, solicite junto ao seu gestor de contas a documentação correspondente a nova implementação e ativação da funcionalidade para sua operação;

• O SDK Android está ainda mais seguro.

Versão 3.0.0​

• A partir dessa versão é necessário adicionar no projeto o arquivo: unico-check-mobile-services.json. Procure o customer success ou o gestor de contas para ter acesso ao Portal do Cliente e seguir o passo a passo necessário;

• Foi disponibilizado mais um frame de captura em documentos: CPF.

• Não é permitido o uso da câmera em emuladores.

Versão 2.0.5​

• Ajuste na captura do log de erro.

Versão 2.0.4​

• Correção de espelhamento de imagem ao utilizar a câmera do tipo "Documento".

Versão 2.0.3​

• Mudança na estrutura de classes.

Versão 2.0.0-beta.5​

• Mudança na estrutura de classes.