IBScanUltimate Getting Started Guide

Machine Translated by Google
Guide de démarrage d'IBScanUltimate

Version 3.9.1 (30 mai 2022)
Copyright @20112022, Integrated Biometrics LLC. Tous droits réservés

Guide de Démarrage
Table des matières
HISTORIQUE DES RÉVISIONS ................................................ ...................................... 3
1. CONTENU DU SDK........................................................ ............................................ 4
1.1. Paquets................................................. .................................................................. ......................................4
1.2. Prise en charge des modèles de scanner ............................................ .................................................................. ................4
1.3. Informations complémentaires................................................................. .................................................................. .....................7
2. GUIDE D'INSTALLATION .................................................. .................................. 8
2.1. Guide d'installation de Windows ............................................................ .................................................................. .........8
Installation du SDK................................................................ .................................................................. ......................................8
Contenu du SDK................................................. .................................................................. ......................................8
Exemples d'applications................................................. .................................................................. ..................................8
2.2. Guide d'installation Linux (Intel) .................................................. .................................................................. ....dix
Ouverture du SDK ............................................................ .................................................................. ..................................dix
Contenu du SDK................................................. .................................................................. .......................................dix
Installation de la bibliothèque IBScanUltimate.................................................. .................................................................. ....10
Compilation et exécution de l'exemple d'application ....................................... ............................................11
2.3. Guide d'installation Linux (ARM)........................................................ .................................................................. ...13
Ouverture du SDK ............................................................ .................................................................. ..................................13
Contenu du SDK................................................. .................................................................. ......................................13
Dépendances................................................................ .................................................................. ......................................14
Compilation de l'exemple d'application....... .................................................................. ......................................................14 Installation
de la bibliothèque IBScanUltimate.................................................. .................................................................. ....15
2.4. Guide d'installation Android.................................................. .................................................................. .........17
Contenu du SDK................................................. .................................................................. ......................................17
Configuration d'un studio Android avec IBScanUltimate .............................................. ......................................18
Ciblage du niveau de l'API Android sur l'application Android (à l'aide de Columbo Mini) ....................................... ........19 Ouverture et
exécution de l'exemple de projet............................... .................................................................. ..........20 L'interface d'application Java
IBScanUltimate ................................. .................................................................. 21
L'interface d'application IBScanUltimate C/C++............................................ ......................................22
Utiliser des périphériques USB sur Android............................................................ .................................................................. ............22
3. GUIDE DE CAPTURE D'EMPREINTES DIGITALES.................................................. ................ 25
3.1. Captures d'impression à plat................................................. .................................................................. ......................25
Page 1
Guide de Démarrage
3.2. Captures d'impression roulées .................................................. .................................................................. ............26
3.3. Utilisation frauduleuse.................................................. .................................................................. ..................................27
4. PRISE EN CHARGE DES MODÈLES ISO .............................................. ...................... 28
4.1. Présenter le modèle ISO............................................................ .................................................................. ............28
4.2. Exportation d’images d’empreintes digitales vers un modèle ISO ............................................ ......................................28
4.3. Vérifier le modèle ISO avec BiOCTS.................................................. ......................................................29
page 2
Guide de Démarrage
Historique des révisions
Date Remarques de l'auteur
2022/05 Milton a ajouté la prise en charge des modèles ISO
2020/01 Milton Ajout d'une utilisation frauduleuse
INTERDICTION 2013/10 Erreur typographique corrigée dans la section de démarrage de Linux (ARM).
page 3
Guide de Démarrage
1. Contenu du SDK
1.1. Paquets
Le SDK IBScanUltimate complet se compose de six packages distincts pour des systèmes d'exploitation
individuels. Le cœur de chaque package est la bibliothèque IBScanUltimate (distribuée sous forme de DLL
sur Windows et de bibliothèques d'objets partagées sur d'autres platesformes) qui fournit une API pour
capturer des images à partir des scanners IB. Un ou plusieurs exemples d'applications dans chaque
package démontrent l'utilisation de la bibliothèque. Une interface Java est également disponible, via un pont JNI
(distribué sous forme de DLL sous Windows) et un wrapper en langage Java (distribué sous forme de
JAR).
Voici les packages fournis, où « xyz » est le numéro de version tel que « 1.6.7 » :
• IBScanUltimateSDK Setup xyzexe est le programme d'installation pour tous les Windows 32 bits.
platesformes, notamment XP, Vista, Windows 7 et Windows 8. Des exemples d'applications sont fournis
pour une variété de langages, parmi lesquels C/C++, C#, VB et Java.
• IBScanUltimateSDK(x64) Setup xyzexe est le programme d'installation pour tous les Windows 64 bits.
platesformes, notamment XP, Vista, Windows 7 et Windows 8. Des exemples d'applications sont fournis
pour une variété de langages, parmi lesquels C/C++, C#, VB et Java.
• IBScanUltimate_x86_x.yztgz est la version pour les distributions Linux 32 bits (x86) ; la bibliothèque
fournie devrait fonctionner sur les noyaux 2.6 et versions ultérieures. Un exemple d'application est fourni
pour C/C++.
• IBScanUltimate_x64_x.yztgz est la version pour les distributions Linux 64 bits (x64) ; la bibliothèque
fournie devrait fonctionner sur les noyaux 2.6 et versions ultérieures. Un exemple d'application est fourni
pour C/C++.
• IBScanUltimate_armv7a_x.yztgz est la version pour ARMv7A (CortexA5,

CortexA8, CortexA9) Distributions Linux ; la bibliothèque fournie devrait fonctionner sur les noyaux 2.6
et versions ultérieures. Un exemple d'application est fourni pour C/C++.
• IBScanUltimate_armv8a_x.yztgz est la version pour ARMv8 bsed Linux

distributions ; la bibliothèque fournie devrait fonctionner sur les noyaux 2.6 et versions ultérieures.
Un exemple d'application est fourni pour C/C++.
• IBScanUltimate_Android_x.yztar.gz est la version pour Android ; la bibliothèque fournie devrait

fonctionner sur les versions v4.0.0 et ultérieures d'Android. Un exemple d’application est fourni.
1.2. Prise en charge des modèles de scanner
IBScanUltimate prend en charge les capteurs d'empreintes digitales biométriques intégrés suivants :
• Watson
• Watson Mini
•Sherlock
• Columbo
page 4
Fonctionnalité Watson Watson Mini Sherlock Columbo Courbe Courbe électronique
Type de capteur Émettant de la lumière Émettant de la lumière Émettant de la lumière Émettant de la lumière Émettant de la lumière Émettant de la lumière
capteur (LES) capteur (LES)
CMOS CEI Capteur CMOS CIS (LES) Caméra TFT Capteur CMOS CIS (LES) Capteur CMOS CIS (LES) Capteur CMOS CIS (LES)
caméra caméra caméra caméra caméra
Résolution 500 pixels/pouce 500 pixels/pouce 500 pixels/pouce 500 pixels/pouce 500 pixels/pouce 500 pixels/pouce
1,6" x 1,5" 1,6" x 1,5" 1,6" x 1,5" 0,8" x 1,0"
page 5
Détection active 0,6" x 0,7" (15 0,6" x 0,7" (15
zone
mm x 18 mm) mm x 18 mm)
Taille de l'image 800x 750 800x 750 800x 750 400 x 500 pixels 288x352 288x352
pixels pixels pixels pixels pixels
Taille physique du 63 mm x 70 mm 60 mm x 61 mm 60 mm x 64 mm 39 mm x 46,5 21 mm x 29,5
x 32 mm x 34 mm x 14 mm mm x 27,5 mm x 33,2 mm (hauteur) 69,7 mm (diamètre)mm x 21,5 mm
Carte USB 62 mm x 55 mm N/A N/A 52 mm x 45 mm N/A 75 mm x 45 mm
• Courbe et eCurve
grandeur physique
Guide de Démarrage
Interface USB2.0 USB2.0 USB2.0 USB2.0 USB2.0 USB2.0

Fréquence d'images 15 images/sec 15 images/s 10 images/s 7 images/s 7 images/s 7 images/s

Certifications PIV Non certifié Non certifié
IQS d'identification mobile IQS d'identification mobile IQS d'identification mobile IQS d'identification mobile
SAP45 2Fdoigt
Annexe SAP45 2Fdoigt
Annexe SAP45 2Fdoigt
Annexe SAP30
et rouleau certifié et rouleau certifié et rouleau certifié
Fonctionnalité Watson Watson Mini Sherlock Columbo Courbe Courbe électronique
Empreinte digitale Plat à un doigt Plat à un doigt Plat à un doigt Plat à un doigt Plat à un doigt Plat à un doigt
types de capture
Plat à deux doigts Plat à deux doigts Plat à deux doigts
Roulé avec un seul doigt Roulé avec un seul doigt Roulé avec un seul doigt
LED* Rouge, Vert Non supporté Non supporté Non supporté Prise en charge Non supporté
Détecteur tactile** Prise en charge Non supporté Non supporté Non supporté Non supporté Non supporté
Puissance LE Prise en charge Prise en charge Non supporté Prise en charge Prise en charge**** Non supporté
Fonctionnement*** Windows, Linux, Windows, Linux, Windows, Linux, Windows, Linux, Windows, Linux, Windows, Linux,
Android Android Android Android Android Android
page 6
systèmes
* Si elles ne sont pas prises en charge, les fonctions API IBSU_GetLEDs() et IBSU_SetLEDs() ne sont pas prises en charge
** Si elle n'est pas prise en charge, la fonction API IBSU_IsTouchedFinger() n'est pas prise en charge
*** Si elles ne sont pas prises en charge, les fonctions IBSU_GetLEOperationMode() et IBSU_SetOperationMode() ne sont pas prises en charge
****Contrôle l'entrée du capteur tactile
Guide de Démarrage
Guide de Démarrage
Tous les modèles sont pris en charge par la version de chaque plateforme. Le tableau 1
résume les fonctionnalités des capteurs individuels et le tableau 2 résume les
fonctionnalités d'IBScanUltimate prises en charge pour chacun.
1.3. Informations complémentaires
Pour plus d'informations sur l'API C/C++ de la bibliothèque IBScanUltimate, veuillez vous référer au
manuel de l'API IBScanUltimate pour C.pdf.
Pour plus d'informations sur l'API Java (y compris l'API Android) de la bibliothèque
IBScanUltimate, veuillez vous référer au Manuel de l'API IBScanUltimate pour Java (et
Android).pdf.
Pour l’historique des versions d’IBScanUltimate, veuillez vous référer à IBScanUltimate Version
History.pdf.
Pour plus d'informations sur un modèle de scanner, veuillez vous référer à son manuel matériel.
page 7
Guide de Démarrage
2. Guides d'installation
Chacune des sections suivantes décrit la procédure d'installation sur une plateforme et résume le contenu qui
sera installé avec le SDK.
2.1. Guide d'installation de Windows

Installation du SDK
Exécutez (généralement en doublecliquant) le programme d'installation de Windows, qui sera
Configuration du SDK IBScanUltimate xyzexe
pour le contenu 32 bits et
IBScanUltimate(x64) SDK Setup.xyzexe
pour le contenu 64 bits. Progressez grâce à l’installateur automatique ; nous vous recommandons
d'accepter les valeurs par défaut chaque fois que vous y êtes invité.
Contenu du SDK
Le SDK contient la bibliothèque et l'exemple d'application nécessaires pour commencer à développer une
application Windows qui s'interface avec un scanner IB. Le matériel est séparé en plusieurs répertoires, dont les
suivants :
• Le répertoire /Bin contient des exemples d'applications compilés, la DLL IBScanUltimate (IBScanUltimate.dll)
ainsi que les DLL et JAR pour l'interface Java (IBScanCommon.jar, IBScanUltimate.jar,
IBScanUltimateJNI.dll).
• Le répertoire /Driver contient les pilotes des scanners IB. Ceuxci auraient dû être installés avec le
programme d'installation du SDK.
• Le répertoire /Include contient les fichiers d'inclusion pour l'interface C de

IBScanUltimate.
• Le répertoire /Lib contient le fichier de bibliothèque IBScanUltimate compilé pour la liaison.
• Le répertoire /Sample sources contient la source des exemples d'applications.

Les candidatures sont séparées par langue.
Exemples d'applications
Les exemples d'applications compilés doivent apparaître dans le menu du programme, qui sera également lié
au dossier contenant la source des applications. Les applications suivantes sont fournies (répertoriées
par les noms qui apparaissent dans le menu du programme) :
• Une série d'exemples de base pour plusieurs langages différents, chacun offrant la même interface
graphique et les mêmes commandes essentielles pour les opérations de base du scanner :
o IBScanUltimate_SampleForC# est l'exemple de base pour C#.
o IBScanUltimate_SampleForDelphi est l'exemple de base pour Delphi.
page 8
Guide de Démarrage
o IBScanUltimate_SampleForVBNet est l'exemple de base pour VB.Net.
o IBScanUltimate_SampleForVisualBasic est l'exemple de base pour VB6.
o IBScanUltimate_SampleForVC est l'exemple de base pour C/C++.
• IBSU_FunctionTester (un exemple pour C/C++) énumère les fonctions API présentées par
IBScanUltimate pour permettre des tests plus précis des fonctionnalités de bibliothèque
individuelles et la présentation des résultats.
• IBSU_FunctionTesterForJava duplique IBSU_FunctionTester pour l'API Java.
• IBSU_NewFunctionTester (un exemple pour C/C++) améliore IBSU_FunctionTester avec une

interface graphique mise à jour et plus de discrétion sur l'exécution des fonctions API de la bibliothèque.
• IBSU_NonCallbackSample (un exemple pour C/C++) en double

IBScanUltimate_SampleForVC ; cependant, au lieu de s'appuyer sur des rappels, l'application
interroge les fonctions API de la bibliothèque pour obtenir l'état et les résultats.
• IBSU_TenScanSample (un exemple pour C/C++) parcourt une séquence de

captures pour une numérisation de 10 impressions.
page 9
Guide de Démarrage
2.2. Guide d'installation Linux (Intel)

Ouverture du SDK
Veuillez copier le fichier IBScanUltimate_x86_x.yztgz ou IBScanUltimate_x64_x.yztgz sur votre système de

développement. Extrayez le contenu avec la commande suivante (en remplaçant x64 par x86, si nécessaire,
et le numéro de version par xyz) :
# tar zxvfp IBScanUltimate_x86_x.yztgz
Contenu du SDK
Le SDK contient la bibliothèque et l'exemple d'application nécessaires pour commencer à développer

une application Linux qui s'interface avec un scanner IB. Le matériel est séparé en trois répertoires :
Le répertoire /include contient les fichiers d'inclusion pour l'interface C de

IBScanUltimate.
Le répertoire /install contient un script (InstallIBScanUltimate) pour installer la bibliothèque

IBScanUltimate ainsi que la bibliothèque ellemême (libIBScanUltimate.so).
Le répertoire /Samples contient le code source de l'exemple d'application.
Installation de la bibliothèque IBScanUltimate
Tout d’abord, branchez le périphérique USB IB sur votre port hôte USB.
Deuxièmement, installez la bibliothèque de pilotes IB sur votre système Linux avec des commandes (en
remplaçant x64 par x86, si nécessaire, et le numéro de version par xyz) :
# cd IBScanUltimate_x86_x.yz/install # sudo ./install

IBScanUltimate
Certaines distributions Linux (comme Ubuntu) nécessitent un accès root, obtenu avec la commande
sudo, pour installer la bibliothèque de pilotes.
page 10
Guide de Démarrage
Compilation et exécution de l'exemple d'application

Vous pouvez maintenant compiler et exécuter notre exemple
de programme : # cd ../Samples/Linux/TestScan
# faire
# sudo ./testScanU
En fonction des autorisations que vous avez accordées à l'utilisateur pour accéder aux périphériques
USB, vous devrez peutêtre accorder un accès root pour exécuter l'exemple de programme.
page 11
Guide de Démarrage
page 12
Guide de Démarrage
2.3. Guide d'installation Linux (ARM)

Ouverture du SDK
Copiez le fichier IBScanUltimate_armv7a_x.yztgz sur votre hôte (votre ordinateur de bureau Linux ou votre
machine virtuelle) ou votre cible (le périphérique ARM Linux). Étant donné que l'exemple d'application devra
peutêtre être reconstruit, le choix dépendra de l'emplacement de vos outils de génération (soit un
compilateur croisé sur l'hôte, soit des outils natifs sur la cible). (Dans les exemples de commandes ci
dessous, les systèmes de build et cibles sont différenciés par leurs invites :
Build : $ contre Target : $, même si ceuxci coïncideront si vous construisez de manière native.)
Extrayez le contenu avec la commande suivante (en remplaçant le numéro de version par xyz) :
Construction : $ tar zxvfp IBScanUltimate_armv7a_x.yztgz
Contenu du SDK
Le SDK contient la bibliothèque et l'exemple d'application nécessaires pour commencer à développer

une application Linux qui s'interface avec un scanner IB. Le matériel est séparé en cinq répertoires :
Le répertoire /bin contient des versions de l'exemple d'application compilé (testScanU),

séparées en répertoires par ABI. Ces binaires ont été compilés dynamiquement avec les
bibliothèques dépendantes sous un compilateur croisé et peuvent ne pas s'exécuter sur toutes
les cibles. Vous devrez peutêtre recompiler l'application
page 13
Guide de Démarrage
avec la chaîne d'outils appropriée.
Le répertoire /include contient les fichiers d'inclusion pour l'interface C de

IBScanUltimate.
Le répertoire /install contient un script (InstallIBScanUltimate) pour installer la bibliothèque

IBScanUltimate.
Le répertoire /lib contient des versions de la bibliothèque IBScanUltimate

(libIBScanUltimate.so) séparées en répertoires par ABI.
Le répertoire /Samples contient le code source de l'exemple d'application.
La distribution dispose de binaires et de bibliothèques distincts pour deux ABI :
La version armlinuxgnueabi doit être installée sur les platesformes dotées de bibliothèques
système et d'applications conçues pour l'ABI à virgule flottante « douce », équivalente à
Drapeaux du CCG
mthumb mfloatabi=softfp march=armv7a
La version armlinuxgnueabihf doit être installée sur les platesformes dotées de bibliothèques
système et d'applications conçues pour l'ABI à virgule flottante « dure », équivalente à
Drapeaux du CCG
mthumb mfloatabi=hard march=armv7a
Dépendances
La bibliothèque IBScanUltimate nécessite que libusb 1.0dev soit installé sur la cible.
Sur Ubuntu, vous utiliseriez aptget :
Cible : $ sudo aptget install libusb1.00dev
Lors de la compilation de votre application, vous devez établir une liaison dynamique avec ces deux
bibliothèques, libIBScanUltimate.so, et plusieurs bibliothèques C++ standard :
Construire :$ gcc monapp.c o monapp l IBScanUltimate l stdc++

l pthread
Cette commande ignore l'inclusion des répertoires d'inclusion et de bibliothèque IBScanUltimate.
En fonction du fichier installé par le gestionnaire de packages, les mêmes liens peuvent être
nécessaires sur le système cible pour exécuter une application collectant des empreintes digitales
avec IBScanUltimate.
Compilation de l'exemple d'application

Sur certaines cibles, les exemples de fichiers binaires fournis peuvent ne pas s'exécuter car ils sont
compilés avec des versions récentes du runtime C. Pour recompiler l'exemple, accédez au répertoire Samples/
Linux/TestScan . Définissez et exportez la variable CROSS_COMPILE vers le préfixe de
vos outils, si vous ne construisez pas nativement, et définissez et
page 14
Guide de Démarrage
exportez la variable ARCHABI vers armlinuxgnueabi ou armlinuxgnueabi, selon l'ABI.

Enfin, créez l'application (testScanU), qui sera affichée dans un répertoire bin local .
Construction : $
cd IBScanUltimate_armv7a_x.xx/Samples/Linux/TestScan
Build :$ export CROSS_COMPILE=/mygcc/bin/armlinuxgnueabiBuild:$ export
ARCHABI=armlinuxgnueabi
Construire : $ faire
Si vous effectuez une compilation croisée, les versions natives de libusb1.0 doivent être « installées » dans la structure de
bibliothèque d'exécution de votre chaîne d'outils ou sur un chemin de recherche de bibliothèque.
Installation de la bibliothèque IBScanUltimate
Un script est fourni pour installer la bibliothèque libIBScanUltimate.

Transmettez ce script (sudo sh installIBScanUltimate) et le fichier de règles qui l'accompagne
(IBScan.rules), trouvé dans le répertoire d'installation de la distribution, à votre système cible, avec
la version appropriée de libIBScanUltimate.so et (éventuellement) l'échantillon compilé.
application.
Une fois les fichiers localisés sur votre cible exécutez le script par votre plateforme,
demander un accès root si nécessaire
[Linuxx86,x64]
Cible : $ sudo sh installIBScanUltimate.sh
[Linux armv7gnueabihf]
Cible : $ sudo sh installIBScanUltimate_armv7_gnueabihf.sh
[Linux armv7gnueabihf]
Cible : $ sudo sh installIBScanUltimate_armv7_gnueabi.sh
[Linux armv8]
Cible : $ sudo sh installIBScanUltimate.sh
page 15
Guide de Démarrage
Exécuter l'exemple d'application

Vous pouvez maintenant exécuter l'exemple d'application :
Cible : $ sudo ./testScanU

En fonction des autorisations de l'utilisateur pour accéder aux périphériques USB, vous devrez peutêtre
accorder un accès root pour exécuter l'exemple de programme.
page 16
Guide de Démarrage
2.4. Guide d'installation d'Android

Contenu du SDK
Le SDK contient les applications et bibliothèques nécessaires pour commencer à développer une application
Android qui s'interface avec un scanner IB. Le matériel est séparé en cinq répertoires :
• Le répertoire /bin ne contient qu'un seul fichier : une version compilée du BI.
Application SimpleScan. Pour installer cette application, ouvrez une fenêtre de terminal, accédez
à ce répertoire et utilisez ADB pour installer l'application sur votre téléphone ou tablette Android
connecté. Assurezvous que adb (ou adb.exe, sous Windows), situé dans le répertoire
platformtools du SDK Android , se trouve sur le PATH ou référencé par son chemin
complet.
Si vous avez plusieurs appareils Android connectés ou si un émulateur est

ouvert, vous devrez peutêtre utiliser le commutateur ADB –s avec l'identifiant
approprié pour diriger l'installation vers la cible souhaitée.
Vous trouverez l'application installée répertoriée sous le nom « IB SimpleScan ».
• Le répertoire /lib contient quatre dossiers, chacun contenant des versions compilées
des bibliothèques dont vous aurez besoin pour le développement.
• Le répertoire /include contient les fichiers d'inclusion pour l'interface native de

IBScanUltimate.
• Le répertoire /Samples contient le code source de l'exemple SimpleScan.
l'application, la distribution libusb spécifiquement pour les systèmes Android non rootés et le wrapper
qui expose à l'application une interface Java pratique pour communiquer avec les
scanners IB.
page 17
Guide de Démarrage
Configuration d'un studio Android avec IBScanUltimate
Comme le montre la structure de projet Android

de droite,
les projets IBScanCommon et IBScanUltimate
existent.
Projet IBScanCommon configuré par le langage Java

uniquement.
Projet IBScanUltimate configuré par Java + Native Library

combinés.
Dans le projet IBScanUltimate, qui contient le dossier
jniLibs et ce dossier inclut les fichiers de bibliothèque native
basés sur C inclus par ABI
(arm64v8a, armeabiv7a,x86,x86_64)
Vous avez besoin de ces deux

modules (IBScanCommon+IBScanUltimate)
importez sur votre projet de studio Android pour créer
votre application Android.
Si vous préférez importer un fichier de bibliothèque au

lieu de la structure du
module, vous pouvez utiliser des fichiers AAR (Android Archive).
Dans notre répertoire Release package /Lib, vous
pouvez trouver deux fichiers *.aar.
iBScanCommonrelease.aar
iBScanUltimaterelease.aar
Dans le fichier iBScanUltimaterelease.aar, incluez les

fichiers de bibliothèque natifs suivants.
libusb.so
libuvc.so
libAKXUS.so
libIBScanUltimate.so
libIBScanUltimateJNI.so
libLiveFinger2.so
(package compatible PAD)
page 18
Guide de Démarrage
Ciblage du niveau d'API Android sur l'application Android (à l'aide de Columbo Mini)
Si vous envisagez d'utiliser l'appareil Columbo Mini sur la plateforme Android,

Columbo Mini fonctionne comme caméra (Webcam UVC) sur l'appareil Android.
Récemment, Google a augmenté/appliqué la sécurité sur la plateforme Android concernant Camara et USB.
Par conséquent, si vous utilisez Columbo Mini sur le dernier appareil Android, vous devez vérifier le niveau de
l'API Android de votre application.
Si le niveau de l'API cible de l'application Android est supérieur (>=) à 28 (Android

P) → Vous devez ajouter l'autorisation Caméra sur votre fichier Android Manifest.xml pour
reconnaître Columbo Mini dans l'application Android.
<?xml version="1.0" encoding="utf8"?> <manifest
xmlns:android="http://schemas.android.com/apk/res/android"
package="com.integratedbiometrics.ibsimplescan">
<usesfeature android:name="android.hardware.usb.host"/>
<usespermission android:name="android.permission.CAMERA"/>
<demande>
…
</application> </
manifeste>
page 19
Guide de Démarrage
Ouverture et exécution de l'exemple de projet

L'exemple de projet IB SimpleScan se trouve dans le répertoire /
Sample/Android/SimpleScanSample . Pour ouvrir ce projet dans Android Studio
• Cliquez sur « Projets » → « Ouvrir »
Une fois le projet chargé terminé, l'échantillon apparaîtra sous la liste des
applications avec le nom « IB SimpleScan ». Quand l'application
ouvert, il détectera tous les scanners connectés ou attendra jusqu'à ce qu'il
reçoive une notification indiquant qu'un scanner a été connecté. Après l'IB
Le scanner est connecté, sélectionnez le type de numérisation et appuyez sur le
bouton « Démarrer » pour initialiser le
scanner, puis capturez une numérisation.
Une fois l'analyse terminée, un
clic long sur l'image avec l'empreinte
digitale fera apparaître un menu
contextuel avec des options pour
envoyer l'image par courrier
électronique et afficher une version agrandie.
page 20
Guide de Démarrage
L'interface d'application Java IBScanUltimate

Les bibliothèques SDK fournissent une interface Java pour la commodité de l'application, le tout dans le
package com.integratedbiometrics.ibscanultimate. Les cinq classes principales de ce package exposent
toutes les fonctionnalités des bibliothèques natives IBScanUltimate sous Linux, avec une interface
plus optimale pour la programmation Java.
Pour plus d'informations audelà de la brève introduction cidessous, veuillez consulter le manuel de l'API Java.
• IBScan : Le gestionnaire de scanners. La classe principale, IBScan, gère les scanners. En règle générale,
l'activité principale d'une application obtiendra un handle vers l'instance unique de la classe IBScan dans
sa méthode onCreate() :
ceci.m_ibScan =
IBScan.getInstance(this.getApplicationContext());
Avec ce handle, l'application peut utiliser les services fournis par IBScan, notamment
l'obtention d'une description de la version du SDK, l'obtention de la description d'un périphérique
et l'ouverture d'un handle vers un scanner.
• IBScanListener : écouteur d'événements du gestionnaire de scanner. Généralement,

l'application enregistrera un IBScanListener pour recevoir des notifications :
this.m_ibScan.setScanListener(this);
Dans ce cas, l'activité implémente l'interface IBScanListener ellemême, par exemple :

classe publique MyActivity étend l'activité
implémente IBScanListener {
L'écouteur doit remplacer un certain nombre de méthodes. Plusieurs (abordés plus en détail dans
la section sur les périphériques USB cidessous) alertent l'application sur les événements importants
pour le cycle de connexion du périphérique (attaché, autorisation accordée, nombre de
périphériques modifiés, détachés). Les deux autres sont importants pour la procédure d’ouverture d’un
appareil.
• IBScanDevice : poignée du scanner. Un handle vers un scanner est renvoyé par l'une des fonctions
synchrones IBScan openDevice() ou via le rappel scanDeviceOpenComplete() lors de l'utilisation
de l'une des fonctions asynchrones openDeviceAsynch().
• IBScanDeviceListener : écouteur d'événements du scanner. Généralement, le

l'application enregistrera un IBScanDeviceListener pour recevoir des notifications :
this.m_ibScanDevice.setScanDeviceListener(this);
Dans ce cas, l'activité implémente l'interface IBScanDeviceListener ellemême, par exemple :
classe publique MyActivity étend les implémentations d'activité
IBScanDeviceListener {
L'écouteur doit remplacer un certain nombre de méthodes. Tous ces éléments sont appelés pendant la
capture (après avoir appelébeginCaptureImage()) pour permettre à l'application de répondre
dynamiquement, par exemple en mettant à jour son affichage de l'analyse en cours sans avoir
besoin d'interroger l'appareil.
• IBScanException : l'exception du scanner. La plupart des IBScan et IBScanDevice

les retours peuvent lancer une exception IBScanException, que l'application doit intercepter. Un
page 21
Guide de Démarrage
Une exception peut avertir qu'une opération est illégale (comme la définition d'une propriété en
lecture seule) ou qu'une erreur s'est produite (comme une erreur d'E/S suite à un échec de
communication).
int DeviceIndex = 0 ;
essayer
IBScanDevice monDevice = this.m_ibScan.open(deviceIndex);
attraper (IBScanException ibse)
System.out.println ("Échec de l'ouverture avec exception " +
ibse.getCode().toString();
L'interface d'application IBScanUltimate C/C++
En général, l'API Java sera le meilleur choix pour une application souhaitant contrôler un scanner IB, car elle
s'occupe des détails compliqués de l'encapsulation des bibliothèques natives IBScanUltimate.
Puisque certaines applications peuvent préférer coder certaines opérations (par exemple le
traitement d’images) en C ou C++, l’interface native de la bibliothèque est accessible. Idéalement, cette API
Android C/C++ est identique à l'API Linux et peut être utilisée de la même manière (sauf pour les particularités
liées à l'utilisation de périphériques USB sur Android ; voir la section suivante). Veuillez consulter le manuel de
l'API Linux pour plus d'informations sur cette API.
Utiliser des périphériques USB sur Android
Les systèmes basés sur Android sont assez verrouillés ; une application ne peut accéder qu’à peu de
choses audelà des limites de son processus et de ses ressources. Les autorisations d'accès à certaines
fonctionnalités, telles que le stockage externe, sont annoncées par l'application dans son manifeste et
l'utilisateur est averti lors de l'installation de l'application. Toutefois, pour les périphériques USB,
l'autorisation est accordée appareil par appareil. Une application peut demander l'autorisation d'accéder à
un certain appareil par programmation (ou devenir un appareil par défaut en enregistrant son intérêt
pour certaines catégories par fournisseur et ID de produit ou classe), après quoi l'utilisateur est invité à
approuver ou à refuser dans une boîte de dialogue contextuelle. Si l'utilisateur approuve, l'application
peut accéder à l'appareil.
Dans le cadre de cette interface IBScanListener, plusieurs méthodes doivent être remplacées ; Aux fins de
cette discussion, deux sont les plus pertinentes. Lorsqu'un périphérique d'analyse IB est connecté, la
méthode scanDeviceAttached() sera appelée, offrant à l'application la possibilité de demander l'autorisation
d'y accéder :
@Passer outre
public void scanDeviceAttached (int deviceId)
page 22
Guide de Démarrage
/* Vérifiez si nous avons l'autorisation d'accéder à cet appareil.

*
Demandez l'autorisation pour qu'il apparaisse comme un scanner IB. */
booléen hasPermission =
this.m_ibScan.hasPermission(deviceId);
si (!hasPermission)
this.m_ibScan.requestPermission(deviceId);
}
Une fois que l'application a répondu à la demande, une autre méthode d'écoute
(scanDevicePermisionGranted()) sera invoquée ; si l'autorisation est accordée, IBScanUltimate
actualisera la liste des appareils qu'il gère en interne, puis informera l'application que le nombre
d'appareils connectés a changé avec scanDeviceCountChanged() afin que
l'application réalise que davantage de scanners sont disponibles.
(Bien entendu, cette méthode sera également invoquée si un scanner est détaché, pour la raison
inverse.)
@Passer outre
public void scanDeviceCountChanged (int deviceCount)

{
/* Le nombre de scanners accessibles reconnus a changé.

* Actualisons la liste des scanners parmi lesquels nous pouvons choisir. */
Si l'application entre dans un état dans lequel UsbManager d'Android ne la notifie pas des
pièces jointes des appareils, l'application devra peutêtre parcourir manuellement la liste des
appareils du gestionnaire et demander l'autorisation d'accéder aux scanners inaccessibles :
/* Assurezvous qu'aucun périphérique USB connecté n'est IB

*
scanners pour lesquels l’autorisation n’a pas été accordée. Pour toute
* qui sont trouvés, demander l'autorisation ; nous devrions recevoir un
* rappel lorsque l'autorisation est accordée ou refusée, puis quand
* IBScan reconnaît que de nouveaux appareils sont connectés. */
Gestionnaire UsbManager = (UsbManager)this.getApplicationContext()
.getSystemService(Context.USB_SERVICE);
HashMap<String, UsbDevice> deviceList = manager.getDeviceList();
Itérateur<UsbDevice> périphériqueIterator =
deviceList.values().iterator();
page 23
Guide de Démarrage
tandis que (deviceIterator.hasNext())
Périphérique USBDevice = deviceIterator.next();
booléen isScanDevice = IBScan.isScanDevice(device);
si (isScanDevice)
booléen hasPermission = manager.hasPermission(device);
si (!hasPermission)
this.m_ibScan.requestPermission(device.getDeviceId());
page 24
Guide de Démarrage
3. Guide de capture d'empreintes digitales
3.1. Captures d'impression à plat
Le doigt doit être à la fois correctement aligné et rester en contact avec le boîtier du scanner. Comme le
montre la figure 1a, sur un Watson Mini, le doigt doit être opposé au câble USB et être perpendiculaire au
côté. Sur la figure 1b, vous pouvez voir que le doigt entre en contact avec le boîtier en plastique, comme
nécessaire sur les capteurs Watson Mini, Columbo et Sherlock ; sur un scanner Watson, le contact doit
être établi avec la bande métallique située au bas du scanner.
Figure 1. Bon placement des doigts

(a, à gauche) bon alignement des doigts ; (b, à droite) contact du doigt avec le boîtier du scanner
Figure 2. Mauvais placement des doigts

(a, à gauche) alignement incorrect, doit être en face du câble USB ; (b, milieu) mauvais alignement, doit
être en face du câble USB ; (c, à droite) aucun contact avec le boîtier du scanner
page 25
Guide de Démarrage
3.2. Captures d'impression roulées
Les recommandations pour les captures plates s'appliquent également aux captures plates. Les deux sont corrects
L'alignement des empreintes digitales et le contact avec le sol du scanner sont nécessaires. La capture lancée est une
séquence de trois étapes. Comme le montre la figure 3, le doigt doit rester sur la surface du capteur jusqu'à ce que la capture
de l'impression à plat soit terminée ; dans nos exemples de programmes, cette condition est indiquée par une ligne rouge
(la ligne qui suit l'emplacement de capture) sur l'affichage des empreintes digitales.
Figure 3. Capture roulée, étape 1. Le doigt doit rester sur la surface du capteur
jusqu'à ce que la capture d'impression à plat soit terminée.
Ensuite, comme le montre la figure 4, le doigt doit être roulé vers la gauche jusqu'à ce que tout le côté gauche soit
capturé ; dans nos exemples de programmes, cette condition est indiquée lorsque la ligne qui suit la capture passe du
rouge au vert.
Figure 4. Capture roulée, étape 2. Le doigt doit être roulé vers la gauche jusqu'à ce que
tout le côté gauche est capturé
page 26
Guide de Démarrage
Enfin, comme le montre la figure 5, faites rouler le doigt vers la droite jusqu'à ce que tout le côté droit soit
capturé. La capture roulée se termine lorsque le doigt est retiré de la platine.
Figure 5. Capture roulée, étape 3. Le doigt doit être roulé jusqu'à ce que
tout le côté droit est capturé
3.3. Utilisation frauduleuse
Depuis la version IBScanUltimate 3.2.0, la fonction Spoof a été activée.

Vous pouvez tester la fonction Spoof sur notre programme Sample For VC.
Si vous souhaitez activer la fonction Spoof, cochez la case « Activer Spoof » et sélectionnez la valeur seuil
du seuil Spoof. La propriété Spoof On/Off par défaut est « Off » et la propriété Threshold est « 5 ».
page 27
Guide de Démarrage
4. Prise en charge du modèle ISO
4.1. Présenter le modèle ISO

Depuis la version IBScanUltimate 3.9.0, notre image d'empreinte digitale est convertie en modèle ISO.
Notre support IBScanUltimate suit les normes ISO.
•ISO_19794_2_2005
•ISO_19794_4_2005
•ISO_19794_2_2011
•ISO_19794_4_2011
• ANSI_INCITS_378_2004
• ANSI_INCITS_381_2004
4.2. Exportation d’images d’empreintes digitales vers un modèle ISO
À partir du SDK IBScanUltimate 3.9.0, lorsque

vous avez coché l'option « Enregistrer les images », sélectionnez tous nos exemples d'applications,
Les images FingerPrint sont également enregistrées sous forme de fichiers de modèle ISO comme cidessous.
page 28
Guide de Démarrage
Pour une explication détaillée de la conversion du modèle ISO, veuillez consulter notre IBScanUltimate
API CIBSU_ConvertImageToISOANSI()
et
API Java ConvertImageToISOANSI()
4.3. Vérifier le modèle ISO avec BiOCTS
Une fois que vous avez converti les images FingerPrint converties en modèle ISO, vous devez vérifier que les
fichiers de modèle ISO fonctionnent comme prévu.
Le NIST (https://www.nist.gov/) fournit BioCTS pour le programme ISO/IEC qui vérifie que le modèle ISO contient
des données standard correctes.
Vous pouvez télécharger le programme BioCTS pour ISO/IEC pour le lien cidessous.
[Lien vers BioCTS pour ISO/IEC]
https://www.nist.gov/itl/csd/biometricsresourcecenter/biometricconformancetestsoftwarebiocts/
bioctsisoiec
Une fois le téléchargement terminé, installez le programme BioCTS sur votre ordinateur.
Après l'installation, exécutez le programme BioCTS puis allez dans l'onglet « Option »
Et certaines valeurs de réglage ont changé comme cidessous.
Entête biométrique standard (SBH) : défini sur (Aucun)

Bloc de données biométriques (BDB) : Sélectionnez si vous souhaitez tester la norme ISO/ANSI
Bloc de sécurité (SB) : défini sur (Aucun)
Format de données biométriques XML : défini sur le codage XML
page 29
Guide de Démarrage
• Exemple de test (vérifier la norme ISO 197944:2011)
1) Capturez l'image FingerPrint avec l'option "Enregistrer l'image"
2) Exécutez le programme BioCTS puis allez dans l'onglet « Option » et

changez la valeur du « Bloc de données biométriques » en « ISO 197944:2011 » , puis
cliquez sur le bouton « Appliquer » en bas à droite.
3) Allez dans l'onglet « Test par lots de fichiers binaires » et cliquez sur le bouton « Ajouter des fichiers »
page 30
Guide de Démarrage
4) Sélectionnez le fichier ISO197944:2011 dans l'emplacement enregistré du fichier ISO.
5) Cliquez sur le bouton Lecture « Tester les fichiers »
6) Génial ! Votre modèle Standard est parfait !
(Le champ de résultat a une vérification verte si le test est réussi)
page 31
Guide de Démarrage
Coordonnées de l'assistance :
www.integratedbiometrics.com
Biométrie intégrée, LLC
page 32

IBScanUltimate Getting Started Guide

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

IBScanUltimate Getting Started Guide

Transféré par

Droits d'auteur :

Formats disponibles

Machine Translated by Google

Guide de démarrage d'IBScanUltimate

Copyright @2011­2022, Integrated Biometrics LLC. Tous droits réservés

Table des matières

HISTORIQUE DES RÉVISIONS ................................................ ...................................... 3

1. CONTENU DU SDK........................................................ ............................................ 4

1.1. Paquets................................................. .................................................................. ......................................4

1.2. Prise en charge des modèles de scanner ............................................ .................................................................. ................4

1.3. Informations complémentaires................................................................. .................................................................. .....................7

2. GUIDE D'INSTALLATION .................................................. .................................. 8

2.1. Guide d'installation de Windows ............................................................ .................................................................. .........8

Installation du SDK................................................................ .................................................................. ......................................8

Contenu du SDK................................................. .................................................................. ......................................8

Exemples d'applications................................................. .................................................................. ..................................8

2.2. Guide d'installation Linux (Intel) .................................................. .................................................................. ....dix

Ouverture du SDK ............................................................ .................................................................. ..................................dix

Contenu du SDK................................................. .................................................................. .......................................dix

Installation de la bibliothèque IBScanUltimate.................................................. .................................................................. ....10

Compilation et exécution de l'exemple d'application ....................................... ............................................11

2.3. Guide d'installation Linux (ARM)........................................................ .................................................................. ...13

Ouverture du SDK ............................................................ .................................................................. ..................................13

Contenu du SDK................................................. .................................................................. ......................................13

Dépendances................................................................ .................................................................. ......................................14

Compilation de l'exemple d'application....... .................................................................. ......................................................14 Installation

de la bibliothèque IBScanUltimate.................................................. .................................................................. ....15

2.4. Guide d'installation Android.................................................. .................................................................. .........17

Contenu du SDK................................................. .................................................................. ......................................17

Configuration d'un studio Android avec IBScanUltimate .............................................. ......................................18

exécution de l'exemple de projet............................... .................................................................. ..........20 L'interface d'application Java

IBScanUltimate ................................. .................................................................. 21

L'interface d'application IBScanUltimate C/C++............................................ ......................................22

Utiliser des périphériques USB sur Android............................................................ .................................................................. ............22

3. GUIDE DE CAPTURE D'EMPREINTES DIGITALES.................................................. ................ 25

3.1. Captures d'impression à plat................................................. .................................................................. ......................25

3.2. Captures d'impression roulées .................................................. .................................................................. ............26

3.3. Utilisation frauduleuse.................................................. .................................................................. ..................................27

4. PRISE EN CHARGE DES MODÈLES ISO .............................................. ...................... 28

4.1. Présenter le modèle ISO............................................................ .................................................................. ............28

4.3. Vérifier le modèle ISO avec BiOCTS.................................................. ......................................................29

Historique des révisions

Date Remarques de l'auteur

2022/05 Milton a ajouté la prise en charge des modèles ISO

2020/01 Milton Ajout d'une utilisation frauduleuse

• IBScanUltimate_armv7a_x.yztgz est la version pour ARMv7­A (Cortex­A5,

• IBScanUltimate_armv8a_x.yztgz est la version pour ARMv8 bsed Linux

• IBScanUltimate_Android_x.yztar.gz est la version pour Android ; la bibliothèque fournie devrait

1.2. Prise en charge des modèles de scanner

Interface USB2.0 USB2.0 USB2.0 USB2.0 USB2.0 USB2.0

Fréquence d'images 15 images/sec 15 images/s 10 images/s 7 images/s 7 images/s 7 images/s

1.3. Informations complémentaires

2.1. Guide d'installation de Windows

Exécutez (généralement en double­cliquant) le programme d'installation de Windows, qui sera

Configuration du SDK IBScanUltimate xyzexe

pour le contenu 32 bits et

IBScanUltimate(x64) SDK Setup.xyzexe

• Le répertoire /Include contient les fichiers d'inclusion pour l'interface C de

• Le répertoire /Lib contient le fichier de bibliothèque IBScanUltimate compilé pour la liaison.

• Le répertoire /Sample sources contient la source des exemples d'applications.

o IBScanUltimate_SampleForC# est l'exemple de base pour C#.

o IBScanUltimate_SampleForDelphi est l'exemple de base pour Delphi.

o IBScanUltimate_SampleForVBNet est l'exemple de base pour VB.Net.

o IBScanUltimate_SampleForVisualBasic est l'exemple de base pour VB6.

o IBScanUltimate_SampleForVC est l'exemple de base pour C/C++.

• IBSU_FunctionTesterForJava duplique IBSU_FunctionTester pour l'API Java.

Copyright @20112022, Integrated Biometrics LLC. Tous droits réservés

• IBScanUltimate_armv7a_x.yztgz est la version pour ARMv7A (CortexA5,

Exécutez (généralement en doublecliquant) le programme d'installation de Windows, qui sera

Le répertoire /install contient un script (InstallIBScanUltimate) pour installer la bibliothèque

# cd IBScanUltimate_x86_x.yz/install # sudo ./install

les cibles. Vous devrez peutêtre recompiler l'application

Le répertoire /install contient un script (InstallIBScanUltimate) pour installer la bibliothèque

mthumb mfloatabi=softfp march=armv7a

mthumb mfloatabi=hard march=armv7a

Cible : $ sudo aptget install libusb1.00dev

Construire :$ gcc monapp.c o monapp l IBScanUltimate l stdc++

exportez la variable ARCHABI vers armlinuxgnueabi ou armlinuxgnueabi, selon l'ABI.

Dans le fichier iBScanUltimaterelease.aar, incluez les

Si vous envisagez d'utiliser l'appareil Columbo Mini sur la plateforme Android,

<?xml version="1.0" encoding="utf8"?> <manifest

Dans ce cas, l'activité implémente l'interface IBScanListener ellemême, par exemple :

Dans ce cas, l'activité implémente l'interface IBScanDeviceListener ellemême, par exemple :

/* Assurezvous qu'aucun périphérique USB connecté n'est IB