Veridis Biometrics SDK
Veridis Biometrics SDK
Veridis Biometrics SDK
Versão do SDK: 5.0© 2013 Veridis Biometrics
Versão do SDK: 5.0© 2013 Veridis Biometrics
Versão do SDK: 5.0© 2013 Veridis Biometrics
Versão do Documento
Versão Data Modificações
1 2 3 4 5 23/mar/2011 17/mai/2011 29/jul/2011 3/out/2011 18/fev/2013 Versão original Expansão da Introdução. Novos leitores suportados Hamster III e Hamster DX
SDK 3.0. Biblioteca de alto nível.
SDK 3.2. Biometric SDK FREE. NET HighLevelBiometricServices
SDK 5.0. API totalmente reformulada
Suporte a vários formatos de imagens Carregamento dinâmico dos leitores Licenciamento FREE
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
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.
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.
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:
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.
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.
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.
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
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,