Durante a captura biométrica, é essencial obter imagens de alta qualidade para garantir a precisão do reconhecimento facial/digital e reduzir erros, como falsos positivos ou negativos, evitando retrabalho. Também é importante atender aos padrões internacionais de interoperabilidade, assegurando a confiabilidade e a eficiência do sistema.
Ideal para aplicações como autenticação de usuários, controle de acesso e sistemas de pagamento, o SDK de captura do BioPass ID facilita a integração de tecnologias de reconhecimento biométrico, como facial e de impressão digital, em diferentes dispositivos e sistemas. O recurso auxilia na captura, validação e processamento de imagens de alta qualidade, oferecendo benefícios como integração fácil com sistemas existentes, alta precisão na captura biométrica, conformidade com padrões internacionais de segurança e versatilidade para diversas aplicações. Além disso, o SDK reduz custos, otimiza processos e proporciona uma experiência mais ágil e segura aos usuários.
Neste tutorial, vamos mostrar o passo a passo do processo de captura de imagens biométricas por meio dos SDKs do BioPass ID. Também abordaremos as melhores práticas, configurações e funcionalidades disponíveis.
Boa leitura!
Pré-requisitos para utilizar os SDKs do BioPass ID
Os SDKs do BioPass ID foram desenvolvidos com o objetivo de oferecer máxima flexibilidade e desempenho em diferentes plataformas e dispositivos. No entanto, para garantir que a integração e o uso sejam eficazes, é preciso atender aos pré-requisitos técnicos e seguir as recomendações de boas práticas. Veja os detalhes:
Primeiramente, para utilizar o SDK, o sistema operacional deve ser compatível com web, desktop e dispositivos móveis (Android ou iOS).
As plataformas e dispositivos devem ter:
- Sistema operacional atualizado (Windows, macOS, Android 9+ ou iOS 13+).
- Hardware compatível com sensores biométricos de alta resolução.
- Espaço de armazenamento e memória suficiente para processar as capturas e validações de imagens.
Outro requisito é a configuração correta do ambiente para garantir que a aplicação utilize as funções disponíveis no SDK de forma otimizada.
Passo a passo para captura de imagem com o SDK
Na documentação, é disponibilizado tutoriais para integração do SDK de face, finger e assinatura. Aqui, vamos mostrar o SDK de reconhecimento facial com a tecnologia React Native, que suporta Android e iOS. É importante lembrar que os outros SDKs são tão simples quanto esse.
Passo 1: prepare o ambiente
Antes de começar, verifique se o ambiente de desenvolvimento está previamente configurado com a tecnologia escolhida:
- Utilize React Native (versão mínima 0.65).
- Instale o Node.js e npm/yarn.
- Configure as ferramentas de desenvolvimento para Android e/ou iOS.
Passo 2: instale o SDK
No terminal, dentro do diretório do projeto React Native, execute os seguintes comandos:
- npm install @biopassid/face-sdk-react-native
- Caso esteja utilizando o Yarn:
yarn add @biopassid/face-sdk-react-native
Após a instalação, configure as dependências:
- Android: verifique o arquivo android/build.gradle e adicione as dependências necessárias.
- iOS: certifique-se que o CocoaPods esteja instalado e execute “npx pod-install”
Passo 3: integre o SDK no código
Agora, importe o SDK no projeto e inicialize-o no componente principal do aplicativo:
import FaceSDK from '@biopassid/face-sdk-react-native';
// Inicialize o SDK
FaceSDK.initialize('<YOUR_LICENSE_KEY>');
Lembre-se de substituir <YOUR_LICENSE_KEY> pela chave de licença fornecida pelo BioPass ID.
Passo 4: capture a imagem
Na sequência, realize uma captura com o aplicativo, adicionando um botão ou outro componente para chamar o método de captura conforme o código:
FaceSDK.captureImage() .then((result) => { console.log('Imagem capturada:', result); }) .catch((error) => {console.error('Erro na captura:', error); });
Esse código permite realizar a captura de forma simples e eficiente. Você também pode personalizar a interface de usuário para manter o padrão visual da aplicação.
Passo 5: personalize a interface
Veja um exemplo de personalização utilizando o React Native:
Para chegar a este nível de detalhe, basta adicionar uma variável de estilo como no código abaixo, alterando os itens necessários para o selecionado:
const styles = StyleSheet.create({
container: {
flex: 1,
paddingHorizontal: 30,
backgroundColor: '#FFF',
}
Você vai encontrar a lista completa do que pode ser alterado na documentação do Face SDK React Native.
Dicas para obter a melhor captura com o SDK
Para obter as melhores capturas com o @biopassid/face-sdk-react-native, siga essas dicas e boas práticas, baseadas nas funcionalidades do SDK do BioPass ID:
- Configure parâmetros de qualidade
Certifique-se de utilizar as opções de qualidade recomendadas para que as imagens atendam aos padrões biométricos. O SDK permite ajustar as configurações para garantir capturas mais precisas.
- Forneça feedback ao usuário
Utilize mensagens na tela para ajudar o usuário a posicionar-se corretamente. Por exemplo, mensagens de centralização do rosto ou afastamento da câmera. O recurso oferece feedback em tempo real.
- Evite erros comuns
Oriente o usuário a evitar locais com pouca ou muita luz diretamente no rosto. O tamanho da imagem capturada pode facilitar a integração com outras funcionalidades do BioPass ID, como a API de Liveness Detection. Também é importante certificar-se de que o tamanho da imagem atende aos padrões do sistema. Um ambiente iluminado é essencial para uma boa captura.
SDK de captura e APIs BioPass ID
O SDK de captura aprimora a qualidade das imagens para uso posterior em sistemas, podendo ser usado em conjunto com os pacotes de APIs multibiometrics e Quality. Vamos ao exemplo?
Simule um matching utilizando a impressão digital com a API de extração de biometria. As chamadas devem ser feitas da seguinte forma:
1. Após adquirir a chave de API, faça a inclusão no código da seguinte maneira:
const licenseKey = "your-license-key";
const headers = {
"Content-Type": "application/json",
"Ocp-Apim-Subscription-Key": "your-api-key",
};
2. Feito isso, inclua as chamadas de extração de biometria e matching.
async function extractTemplate(image: string): Promise<string | null> {
const body = JSON.stringify({
Extract: {
Type: "FINGER",
Format: "ISO_IEC_2005_19794_2",
Artifact: image,
},
});
const response = await fetch(
"https://api.biopassid.com/multibiometrics/extract",
{
method: "POST",
headers,
body,
},
);
const status = response.status;
const data = await response.json();
Caso precise, a documentação da API para os campos pode ser acessada diretamente aqui.
3. Inclua a função de Match, recebendo as extrações biométricas.
const response = await fetch(
"https://api2.biopassid.com/multibiometrics/match",
{
method: "POST",
headers,
body,
},
);
const data = await response.json();
console.log("Response status:", response.status);
console.log("Response body:", data);
}
Agora, é só incluir os fingers capturados e a aplicação com match biométrico estará pronta.
Garanta a melhor captura para o usuário
Neste artigo, você conheceu os pré-requisitos para utilizar o SDK de captura do BioPass ID e ainda seguiu o passo a passo para a integração em sistemas. Com suporte a múltiplas plataformas, o recurso oferece uma base robusta, criando sistemas de reconhecimento eficientes e seguros.
O SDK de captura também permite que a aplicação mantenha a identidade visual da empresa. Da preparação do ambiente à configuração dos parâmetros de qualidade e interface, cada detalhe abordado garante que uma solução biométrica seja confiável e eficaz.
Quer saber mais sobre os SDKs do BioPass ID? Fale com um de nossos especialistas e obtenha a licença para integrar as funcionalidades do SDK hoje mesmo.
