VERIDIS

Introdução ao
Veridis Biometrics SDK
Versão do SDK: 5.0© 2013 Veridis Biometrics
VERIDIS
BIOMETRICS
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Versão do Documento
Versão
Data
Modificações
1
23/mar/2011
Versão original
2
17/mai/2011
Expansão da Introdução.
Novos leitores suportados
Hamster III e Hamster DX
3
29/jul/2011
SDK 3.0. Biblioteca de alto nível.
4
3/out/2011
SDK 3.2. Biometric SDK FREE.
NET HighLevelBiometricServices
18/fev/2013
SDK 5.0. API totalmente reformulada
Suporte a vários formatos de imagens
Carregamento dinâmico dos leitores
Licenciamento FREE
5
02
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Sumário
Introdução
Características
Funcionalidades
Sistemas Operacionais
Leitores Suportados
Instalação e licenciamento
Estrutura do SDK
Licenciamento
Instalação do Leitor
Distribuição
Demo
Funcionalidades
Desenvolvimento
Desenvolvimento em .NET
Pré-requisitos
Instalação
Documentação
Sample
Desenvolvimento em Java
Instalação
Documentação
Sample
Distribuição
Desenvolvimento utilizando DLL
Documentação
Sample
Configurações
Distribuição
03
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Introdução
O Veridis Biometric SDK é um kit de desenvolvimento de software contendo algoritmos biométricos e
uma interface de fácil compreensão e programação. Realiza a captura dos dados biométricos, extração
dos templates (representação matemática única de cada amostra) e a comparação. O Veridis
Biometric SDK é o primeiro SDK de qualidade do mercado a suportar leitores de diferentes fabricantes
e não possuir licenciamento pago, ou seja, o seu uso é FREE.
Tudo o que é preciso fazer para incorporar essa tecnologia no seu produto de software está disponível
da forma mais amigável possível nas interfaces do tipo DLL, SO, JAVA e .NET. A figura a seguir mostra o
fluxo dos dois principais processos da biometria: o cadastro do template do usuário e a comparação
entre templates.
04
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Características
Funcionalidades
 Captura de amostras biométricas.
 Modos de captura síncrona e assíncrona.
 Extração de templates.
 Suporte aos padrões internacionais de template ISO 19794-2 e ANSI 378-2004.
 Suporte ao padrão ISO 19794-4.
 Representação do template em Base64.
 Junção de templates (merge) em um único template de alta qualidade.
 Comparação biométrica no modo Verificação (um-para-um).
 Comparação biométrica no modo Identificação (um-para-muitos).
 Multi-plataforma. Windows (32 e 64 bits) e Linux (32 e 64 bits).
 Bibliotecas de baixo nível (DLL e SO) para desenvolvimento em qualquer linguagem de
programação.
 Componentes Java e .NET.
 Documentação completa de todos os componentes, inclusive integrado ao IntelliSense.
Sistemas Operacionais
 Windows XP SP2 (x86 e x64)
 Windows Vista (x86 e x64)
 Windows 7 (x86 e x64)
 Windows Server 2003 (x86 e x64)
 Windows Server 2008 (x86 e x64)
 Ubuntu (x86 e x64)
 Fedora (x86 e x64)
 Suse (x86 e x64)
Leitores Suportados
 Futronic FS-80, FS-88 e FS-90
 Techmag BioTouch
 Nitgen Hamster I,III,DX
 Suprema Biomini, Biomini Plus
 Microsoft Fingerprint Reader*
 DigitalPersona U.are.U 4000B*
*Utilizam o driver LibUSB.
06
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Instalação de Licenciamento
Estrutura do SDK
Pasta
Descrição
\demo
Pasta com a aplicação demo e suas dependências externas
\samples\dotNet\c#
Sample em C#.NET com código fonte
\samples\cpp
Samples em C++ com código fonte
\samples\java
Sample em Java com código fonte
\bin\86
DLLs para Windows (32 bits)
\bin\x64
DLLs para Windows ( 64 bits)
\inc
Includes para desenvolvimento com a biblioteca nativa
\lib\x86
Biblioteca estática para Windows (32 bits)
\lib\x64
Biblioteca estática para Windows (64 bits)
\doc
Documentação do SDK
Licenciamento
O Veridis Biometric SDK não possui qualquer licenciamento pago ou amarrado à máquina. O
seu uso é ilimitado, podendo ser utilizado em qualquer aplicação por um número ilimitado de
usuários. Ao criar uma conta em nosso site, o usuário receberá uma chave (key). Essa chave
deverá ser passada na função VInstallLicense.
Instalação do Leitor
Os leitores Microsoft Fingerprint Reader e Digital Persona U.are.U 4000B utilizam a libUSB.
O driver pode ser baixado em nosso site. Ao conectar o leitor, escolha a instalação manual do
driver e aponte para o driver\Windows\veridis_biometric_driver.inf.
Para os outros leitores suportados, utilize o driver fornecido pelo fabricante.
Distribuição
Para distribuir o Veridis Fingerprint SDK junto com sua aplicação:
Acrescente ao seu pacote de distribuição os arquivos presentes na pasta bin/x86 ou
bin/x64.
Em cada máquina onde será feito a implantação, garanta:
Que o leitor de impressões digitais foi instalado corretamente.
07
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Demo
A aplicação Demo foi desenvolvida para demonstrar os principais objetivos da biometria: cadastro
e identificação. Essa aplicação faz uso do Veridis Biometric SDK 5.0.
A Figura 1 representa a tela principal do programa. Nessa tela são listados os cadastros já
efetuados e as opções de Registrar, Remover e fazer a Identificação através da impressão digital.
Figura 1 - Tela Principal
Funcionalidades
Cadastro: clique no botão Registrar para visualizar a interface de cadastro.
Alteração: com um duplo clique em um dos nomes listados na tela principal, a interface para
edição de cadastro será aberta.
Remoção: para deletar um cadastro existente, selecione o nome na lista e clique em Remover.
Identificação: para realizar uma identificação (busca 1:N), clique em Identificação, aguarde a
interface de captura aparecer e posicione o dedo no leitor biométrico. Caso a
pessoa seja encontrada, a ficha com o cadastro completo dessa pessoa será aberta.
Filtrar: para filtrar a lista por nome, digite o nome ou parte dele no campo Nome.
08
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Figura 2 - Tela de Cadastro
A Figura 2 representa a interface de cadastro. Essa tela é responsável por capturar as informações de uma
pessoa.
Campos biográficos: o documento é obrigatório e deve ser único no banco.
Cadastro biometrico: selecione um dos retângulos acima dos dedos para cadastrar o respectivo dedo.
Uma nova janela será aberta aguardando o posicionamento do dedo no leitor
biométrico. Cada dedo deverá ser capturado três vezes.
Foto: clique no botão com a câmera para começar a capturar imagens da webcam, um novo botão
irá surgir ao lado, clique nele para capturar a imagem final ou cancele clicando novamente no
botão da câmera.
Verificação: em caso de alteração de cadastro, uma verificação deve ser feita para confirmar as alterações.
Clique em verificar e coloque um dedo no leitor. Caso a verificação ocorra com sucesso o
botão ‘Confirmar’ será habilitado.
Cancelar: cancele o cadastro ou edição em qualquer momento clicando em Cancelar.
Confirmação: para efetivar o cadastro ou alteração, clique em Confirmar.
08
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Desenvolvimento em .NET
Pré-requisitos
Visual Studio.
.NET Framework 2.0 ou superior.
Instalação
Adicione uma referência ao Veridis.Biometric no seu projeto:
1
No Solution Explorer, selecione o projeto.
2
No menu Project, clique em Add Reference.
3
A caixa de diálogo Add Reference abre.
4
Selecione a aba Browse.
5
Localize o arquivo Veridis.Biometric.dll na pasta \bin do nosso pacote.
6
Clique em OK, quando tiver localizado o arquivo desejado.
A referência selecionada (Veridis.Biometric) aparecerá na relação de referências do projeto. A
documentação do projeto também estará disponível automaticamente via IntelliSense.
Documentação
Ao referenciar a Veridis.Biometric no seu projeto a documentação inline é importada e aparece no
IntelliSense automaticamente. A documentação também está disponível em formato HTML na
pasta \docs\dotNet do nosso pacote.
Sample
Figura 3 - Sample C#.NET
A figura 3 representa a tela principal do sample em C#.NET. O código fonte desse sample está
disponível no pacote do SDK e pode ser utilizado como um guia para o desenvolvimento de
aplicações que utilizem o .NET Framework.
08
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Desenvolvimento em Java
Instalação
O componente java é distribuido como um pacote JAR, veridisbiometric.jar, presente na pasta \bin
do SDK.
Para utilizá-lo, é necessário:
 Adicionar este pacote ao classpath do seu projeto
Na linha de comando, uso o parâmetro "-classpath path/to/veridisbiometric.jar"
No Eclipse e NetBeans, siga as instruções disponíveis em nosso site.
 Instalar o leitor de impressões digitais, conforme seção “Instalação do Leitor”
Apesar do componente Java utilizar bibliotecas nativas (.dll./so), não é necessário tomar nenhuma
medida adicional, as bibliotecas são carregadas automaticamente.
Documentação
Os documentos Javadoc do componente estão presentes na pasta doc/javadoc.
Sample
O componente acompanha um sample demonstrando as principais funcionalidades do SDK. O
código fonte desse sample pode ser encontrado junto ao pacote de instalação na pasta
samples/java.
Distribuição
 Distribuir o arquivo veridisbiometric.jar bem como as DLLs nativas junto com o seu projeto
 Instalar o leitor de impressões digitais, conforme seção “Instalação do Leitor”
14
Introdução ao Veridis Biometric SDK, © 2013 Veridis Biometrics.
Desenvolvimento utilizando DLL
O uso direto da DLL permite acesso direto às funções do Biometric SDK em muitos ambientes
diferentes, mas é particularmente adequada para o desenvolvimento em C/C++. O pacote inclui:
 Cabeçalho (inc\VrBio.h, inc\VTypes.h, inc\VConsts.h)
 Import library (VrBio.lib), necessário pelo Visual C++ e outras ferramentas. GCC e algumas
outras ferramentas não precisam da Import library para o link.
 Documentação (docs/c), gerada através de doxygen.
Também é possível acessar a DLL a partir de outras linguagens / plataformas, tais como Delphi,
Visual Basic, Python, etc. Para tais linguagens, o programador será responsável por criar as
bibliotecas de importação necessárias.
Documentação
Os documentos Doxygen da API estão presentes na pasta docs/c.
Sample
Os samples em C++ do Veridis Biometrics SDK estão agrupados em uma solução do Visual Studio
2010 (CPPExamples.sln).
Os projetos que fazem parte da solução são do tipo “Console Application” e demonstram as
principais funcionalidades do SDK. Embora o Visual Studio e a linguagem C++ tenham sido
utilizados, os códigos-fontes servem de base para o desenvolvimento em qualquer linguagem
que permita a importação de DLL nativa.
Configurações
Todos os projetos estão configurados para buscar os arquivos de include no caminho “../../../inc” e
a biblioteca estática no caminho “../../../lib/x86”. Além disso, alguns projetos fazem o
carregamento de imagens de arquivo, utilizando para isso o caminho “../../../images”.
Caso a solução tenha sido colocada em uma pasta diferente daquela da instalação do SDK, esses
caminhos devem ser configurados novamente.
Obs: Todos os exemplos fazem a chamada da função VInstallLicense(“YOUR KEY HERE“,null). O
primeiro parâmetro da função deve ser substituído pela chave do usuário, gerada no momento da
criação da conta no site.
Distribuição
Para distribuir o Veridis Biometric SDK junto com sua aplicação, nas máquinas clientes:
Inserir todas as DLLs necessárias na mesma pasta que o seu aplicativo. Estas podem ser
encontradas na pasta bin, dentro da sub-pasta correspondente ao seu sistema (por exemplo,
bin\x86).
 Instalar o leitor conforme seção de "instalação do Leitor".

15
VERIDIS
BIOMETRICS