Fingerspot

FlexCode SDK DeveloperS Guide 1

Terima kasih telah membeli paket Fingerspot FlexCode SDK!

FlexCode SDK sangat sederhana, mudah dipelajari dan mudah digunakan sesuai dengan tuntutan kebutuhan aplikasi Anda. FlexCode SDK
memberikan solusi yang lebih mahir, cocok untuk Anda yang membutuhkan kebebasan lebih dalam berkreasi. Fungsi-fungsi yang
disertakan bersifat lebih mendasar tetapi berkonsep instan, Anda cukup memanggil fungsi-fungsi yang dibutuhkan untuk melakukan
registrasi sidik jari dan verifikasi sidik jari maka FlexCode SDK akan melakukan proses registrasi dan verifikasi yang rumit tanpa Anda perlu
terlibat secara langsung didalamnya. Proses registrasi akan menghasilkan template sidik jari dalam format text yang mudah untuk
disimpan dan distribusikan. Saat Anda ingin melakukan identifikasi jari yang di-scan di alat, template dari proses registrasi digunakan
kembali untuk dibandingkan dengan sidik jari yang di-scan. Anda akan menerima hasil verifikasi apakah jari sama atau tidak. FlexCode SDK
sangat menghemat waktu Anda dalam mengintegrasikan teknologi sidik jari ke aplikasi apapun yang dibutuhkan.

Keunggulan dan fleksibilitas yang Anda dapatkan pada FlexCode SDK :

Format template dalam bentuk text yang mudah disimpan dan distribusikan. Template yang aman karena dienkripsi dengan
kata sandi Anda sendiri.

Keseimbangan antara kecepatan dan keakuratan yang berbaik saat ini dengan rata-rata membandingkan sampai 200 template
sidik jari per detik.

Penggunaan multi alat dalam satu komputer.

Tampilan citra sidik jari terintegrasi ke aplikasi.

Mendukung verifikasi 1 ke 1 dan 1 ke N.

Sistem operasi Windows Xp / Vista / 7 / 8 32 & 64bit

Dirancang khusus hanya untuk alat U.are.U dari Digital Persona, USA.

INSTALASI FLEXCODE SDK
1.
Masukan CD instalasi di drive CD di komputer.
2.
CD instalasi diatur untuk auto run. Jika hal ini tidak terjadi, buka melalui Windows Explorer, lalu jalankan file setup.exe.
3.
Klik dan ikuti langkah-langkah di layar untuk menginstal FlexCode SDK.
4.
Klik dan ikuti langkah-langkah di layar untuk menginstal driver alat. Lalu restart komputer.
5.
Tancapkan alat ke port USB komputer.

MELIHAT CONTOH PROGRAM
Ada 3 contoh program yang disertakan dalam CD instalasi yaitu VB6, Delphi 7 dan VB.NET 2010. Untuk melihat contoh program
dibutuhkan masing-masing program sesuai dengan contoh program tersebut. Sebelum mempelajari contoh program, silahkan jalankan file
executable (FlexCodeSDKSample.EXE) dari contoh program VB6 terlebih dahulu untuk memastikan FlexCode SDK telah terinstal dengan
baik. Untuk penggunaan di Delphi dibutuhkan langkah tambahan selain instalasi FlexCode SDK dan instalasi driver alat yaitu instalasi file
component Delphi.

CONTOH SIDIK JARI
Contoh sidik jari atau yang lebih sering disebut dengan template adalah bentuk digital dari pola sidik jari yang dihasilkan dari proses
registrasi sidik jari. Format template ini adalah text (string) sehingga mudah untuk disimpan dan didistribusikan. Template bukan gambar
sidik jari. Template tidak dapat diubah menjadi gambar sidik jari. Template sifatnya unik, artinya jika jari yang sama diregistrasi berulang-
ulang maka menghasilkan template-template yang berbeda-beda. Template tidak boleh diubah karena akan menyebabkan kegagalan saat
proses verifikasi. Pastikan string template tersimpan dengan sempurna tanpa penambahan atau pengurangan apapun. Hanya ada satu
cara untuk membandingkan apakah jari yang di-scan di alat sama dengan template yaitu dengan menggunakan fungsi verifikasi yang
disediakan FlexCode SDK.

REGISTRASI SIDIK JARI
Registrasi sidik jari adalah proses untuk membuat template sidik jari dari jari yang di-scan di alat. Satu jari yang sama akan di-scan
sebanyak empat kali. FlexCode SDK akan menghasilkan template yang unik untuk jari tersebut. FlexCode SDK dilengkapi dengan algoritma
khusus untuk mengurangi kesalahan saat proses registrasi dilakukan, misalnya gambar hasil scan jari tidak cukup jelas atau posisi jari yang
berbeda-beda dalam empat kali pengambilan gambar sidik jari. Dalam batas-batas tertentu FlexCode SDK masih dapat menghasilkan
template yang baik dan akurat dari proses registrasi yang tidak sempurna tadi.

Untuk melakukan proses registrasi, dimulai dengan perintah deklarasi variabel sebagai berikut :
Dim WithEvents FPReg as FlexCodeSDK.FinFPReg
Set FPReg = New FlexCodeSDK.FinFPReg
FPReg.PictureSamplePath = "C:\FPTemp.BMP"
FPReg.PictureSampleHeight = 2050
FPReg.PictureSampleWidth = 1600

Perintah PictureSamplePath, PictureSampleHeight dan PictureSampleWidth digunakan hanya jika dibutuhkan untuk menampilkan gambar
hasil scan ke tampilan aplikasi.

Setelah deklarasi, lakukan perintah untuk mengisi aktivasi alat sehingga alat dapat digunakan di FlexCode SDK. Aktivasi ini bersifat unik,
artinya setiap alat memiliki kode aktivasi yang berbeda dengan alat yang lain. Aktivasi ini terdapat disampul CD instalasi paket FlexCode
SDK. Berikut ini perintah aktivasi alat :
FPReg.DeviceInfo nomor_seri, kode_verifikasi, kode_aktivasi

Untuk memulai proses registrasi lakukan perintah berikut :
FPReg.FPRegistrationStart "MySecretKey"

Demi keamanan template yang dibuat, maka template dienkripsi dengan menggunakan kata kunci yang dapat didefinisikan sendiri. Kata
kunci yang sama akan digunakan saat proses verifikasi.

Setelah deklarasi variabel dan perintah di atas maka jari dapat di-scan di alat. Jari yang sama harus di-scan sebanyak empat kali. Idealnya
keempat gambar hasil scan harus jelas dengan posisi yang relatif sama. Dalam beberapa kasus bisa saja FlexCode SDK akan meminta
beberapa scan diulang untuk menghasilkan gambar yang lebih baik, sehingga dibutuhkan lebih dari empat kali scan sidik jari di alat.

2 Fingerspot FlexCode SDK Developers Guide

FlexCode SDK menginformasikan jumlah kebutuhan gambar sidik jari untuk menghasilkan template melalui event FPSampleNeeded. Jadi
lakukan scan jari sampai FPSampleNeeded mengembalikan nilai nol.

Saat gambar sidik jari sudah siap untuk digunakan, FlexCode SDK akan menghasilkan event FPRegistrationImage. Gambar sidik jari tersedia
di path sesuai dengan yang didefinisikan di PictureSamplePath. Jika diperlukan gambar sidik jari untuk dokumentasi, gambar ini dapat
disimpan dengan cara mengganti nama atau rename dari file tersebut. Karena template sidik jari bukan gambar dan dari template tidak
dapat diubah menjadi gambar. Silahkan tambahkan baris-baris perintah untuk menyimpan / mengubah nama file gambar ini.

Setelah proses registrasi selesai yaitu saat event FPSampleNeeded mengembalikan nilai nol maka FPRegistrationStatus akan memberikan
nilai r_OK dan template yang dihasilkan akan di dapat di event FPRegistrationTemplate. Selanjutnya template dapat disimpan ke database
atau file dan didistribusikan sesuai dengan kebutuhan.

Untuk membatalkan proses registrasi, cukup panggil perintah FPReg.FPRegistrationStop.

Jika proses registrasi gagal misalnya karena alat belum ditancap ke port USB, aktivasi alat yang di-input salah maka nilai kesalahan bisa
diketahui dari event FPRegistrationStatus.

FlexCode SDK hanya bisa membuat template sidik jari dari hasil scan jari langsung di atas alat. FlexCode SDK tidak bisa digunakan untuk
mengolah file gambar-gambar sidik jari menjadi template. Oleh sebab itu meskipun Anda memiliki file gambar-gambar sidik jari maka tidak
dapat digunakan untuk membuat template. Pembatasan ini karena alasan keamanan.

VERIFIKASI SIDIK JARI
Verifikasi adalah proses untuk membandingkan antara gambar jari yang di-scan di atas alat dengan template sidik jari. Verifikasi bisa
dilakukan 1 ke 1 yang artinya satu kali scan jari dibandingkan dengan satu template tertentu. Verifikasi juga bisa dilakukan 1 ke N yang
artinya satu kali scan jari dibandingkan dengan beberapa template sehingga dapat ditentukan apakah ada template yang cocok dengan jari
yang di-scan. FlexCode SDK dapat melakukan kedua cara verifikasi tersebut.

Untuk melakukan proses verifikasi, dimulai dengan perintah deklarasi variabel sebagai berikut :
Dim WithEvents FPVer As FlexCodeSDK.FinFPVer
Set FPVer = New FlexCodeSDK.FinFPVer
FPVer.PictureSamplePath = "C:\FPTemp.BMP"
FPVer.PictureSampleHeight = 2050
FPVer.PictureSampleWidth = 1600

Perintah PictureSamplePath, PictureSampleHeight dan PictureSampleWidth digunakan hanya jika dibutuhkan untuk menampilkan gambar
hasil scan ke tampilan aplikasi.

Setelah deklarasi variabel, lakukan perintah untuk mengisi aktivasi alat sehingga alat dapat digunakan di FlexCode SDK. Aktivasi ini bersifat
unik, artinya setiap alat memiliki kode aktivasi yang berbeda dengan alat yang lain. Aktivasi ini terdapat disampul CD instalasi paket
FlexCode SDK. FlexCode SDK dapat menangani sampai 10 buat alat dalam satu komputer. Menggunakan banyak alat dalam satu komputer
ini tidak untuk mempercepat proses verifikasi karena alat-alat tersebut tidak dapat digunakan pada saat yang sama. Contoh penggunaan
banyak alat dalam satu komputer, satu alat digunakan di sisi kasir dan satunya lagi di sisi nasabah di Bank, sehingga kerja kasir lebih efektif
karena kasir tidak perlu lagi memindah-mindahkan alat. Berikut ini perintah aktivasi alat :
FPVer.AddDeviceInfo(nomor_seri, kode_verifikasi, kode_aktivasi)

Selanjutnya adalah mendaftarkan template-template sidik jari yang akan digunakan dalam proses verifikasi. Berikut ini perintah untuk
mendaftarkan template sidik jari, FPVer.FPLoad(id_karyawan, indeks_jari, template_jari, "MySecretKey")
Perintah ini dapat dipanggil berulang-ulang, sampai seluruh template yang dibutuhkan di daftarkan. FlexCode SDK membatasi 2000
template yang dapat digunakan dalam verifikasi. Semakin banyak jumlah template yang didaftarkan dalam satu proses verifikasi maka
dibutuhkan waktu yang lebih lama untuk dapat mengenal sidik jari yang di-scan di atas alat. Jadi pilihlan template-template sesuai dengan
kebutuhan.

FlexCode SDK menyimpan daftar template di memory komputer sehingga dapat digunakan berulang-ulang sesuai dengan kebutuhan.
Untuk menghilangkan satu template dari daftar template, gunakan perintah FPVer.FPUnload(id_karyawan, indeks_jari). Gunakan
perintah FPVer.GetFPCount untuk mengetahui jumlah template yang sudah didaftarkan. Untuk mendefinisikan ulang atau menghilangkan
seluruh template dari daftar template di memory komputer, gunakan perintah FPVer.FPListClear.

Proses verifikasi di FlexCode SDK dapat dilakukan di background, artinya FlexCode SDK tetap aktif meskipun aplikasi berjalan dalam kondisi
non aktif misalnya aplikasi di-minimize. Perintah ini membutuhkan hak akses administrator komputer pada sistem operasi Windows Vista,
7 dan 8, dengan kata lain Anda harus menjalankan aplikasi dalam kondisi run as admin. Beri nilai true pada perintah WorkingInBackground
untuk mengatur FlexCode SDK tetap dapat digunakan meskipun aplikasi di-minimize, sebaliknya beri nilai false.

Setelah daftar template diisi, maka proses verifikasi bisa dimulai. Untuk memulai proses verifikasi gunakan perintah
FPVer.FPVerificationStart atau FPVer.FPVerificationStart id_karyawan. Jika id_karyawan tidak diinformasikan maka FlexCode SDK
akan melakukan verifikasi 1 ke N, sebaliknya maka akan melakukan verifikasi 1 ke 1. Setelah perintah ini, FlexCode SDK dalam kondisi
menunggu scan jari dilakukan di atas alat.

Saat jari di-scan di atas alat maka FlexCode SDK akan menginformasikan jika gambar sidik jari sudah siap untuk ditampilkan melalui event
FPVerificationImage. Jika ada template yang cocok dengan jari yang di-scan, maka event FPVerificationID akan menginformasikan
id_karyawan dan indeks_jari. Jika ternyata ada lebih dari satu template yang cocok dengan jari yang di-scan maka event
FPVerificationID akan dipanggil berulang-ulang. Hal ini penting dilakukan untuk mencegah terjadinya pendaftaran template yang sama
atau mirip dengan menggunakan id_karyawan atau indeks_jari yang berbeda. Untuk mengetahui apakah jari berhasil dikenali atau tidak
maka setelah proses selesai dilakukan, FlexCode SDK akan menghasilkan event FPVerificationStatus dengan satus v_OK jika jari dikenali
dan hanya ada satu template yang cocok dari seluruh template yang ada di daftar template, status v_NotMatch jika jari tidak dikenali, status

Fingerspot FlexCode SDK DeveloperS Guide 3

v_MultiplelMatch jika ada lebih dari satu template yang cocok dengan jari yang di-scan dan status-status lain jika terjadi kegagalan

verifikasi atau pembatalan.

Proses verifikasi tetap dalam kondisi siap digunakan untuk scan jari selanjutnya atau dilakukan pemanggilan perintah FPVerificationStop
untuk menghentinkan proses verifikasi. Daftar template sidik jari dapat digunakan berulang-ulang, sewaktu-waktu bisa ditambahkan
template lain atau salah satu template dibuang dari daftar tersebut. Daftar template ini dapat terus digunakan selama variabel verifikasi
masih aktif.

Di contoh code VB6 dan Delphi 7 disediakan contoh untuk mengetahui kecepatan verifikasi di komputer yang Anda gunakan. Untuk
keperluan ini, dibutuhkan 2 buah template sidik jari. Template pertama akan di daftarkan dengan identitas yang berbeda yaitu dari nomor
1 sampai 1999. Template kedua akan di daftarkan dengan nomor identitas 2000. Selanjutnya cukup meng-scan jari yang diregistrasi
sebagai template kedua, tunggu beberapa saat sampai jari dikenali. Jika jari dari template pertama di-scan di alat, maka event
FPVerificationStatus akan mengembalikan nilai v_MultiplelMatch. Rata-rata kecepatan SDK bisa mencapai 200 jari per detik dengan
spesifikasi komputer Pentium IV keatas dengan memory minimal 1GB. Kecepatan verifikasi sangat tergantung pada jumlah template yang
dibandingkan dan spesifikasi komputer yang digunakan.

MENGAMBIL GAMBAR SIDIK JARI SAJA
Jika hanya dibutuhkan gambar sidik jari saja, tanpa memerlukan proses registrasi dan verifikasi sidik jari maka lakukan deklarasi variabel
sebagai berikut :
Dim WithEvents FPImage As FlexCodeSDK.FinFPImg
Set FPImage = New FlexCodeSDK.FinFPImg
FPImage.PictureSamplePath = "C:\FPTemp.BMP"
FPImage.PictureSampleHeight = 2050
FPImage.PictureSampleWidth = 1600

Langkah berikutnya adalah mengisi aktivasi alat yang digunakan sehingga dapat dikenali oleh FlexCode SDK. Aktivasi ini terdapat disampul
CD instalasi paket FlexCode SDK. Berikut ini perintah aktivasi alat :
FPImage.DeviceInfo nomor_seri, kode_verifikasi, kode_aktivasi

Untuk memulai scan jari, silahkan gunakan perintah FPImageStart, lalu jari bisa di-scan di atas alat. Saat gambar sidik jari siap ditampilkan,
FlexCode SDK akan menginformasikan melalui event FPImage, silahkan gambar ditampilkan dan disimpan sesuai dengan keperluan. Untuk
memberhentikan proses pengambilan gambar, panggil perintah FPImage.FPImageStop.

Jika terjadi kegagalan proses pengambilan gambar seperti alat belum ditancapkan ke port USB komputer atau alat belum diaktivasi, maka
FlexCode SDK akan menginformasikan melalui event FPImageStatus.

MENDISTRIBUSIKAN FLEXCODE SDK DALAM APLIKASI ANDA
Untuk menginstal aplikasi yang sudah dikembangkan ke komputer lain, maka perlu disertakan file FlexCodeSDK.dll. File ini terletak di folder
tempat FlexCode SDK di install. Default folder instalasi FlexCode SDK di C:\Program Files\FlexCodeSDK. File ini bisa disertakan dalam file
setup aplikasi Anda. File ini perlu didaftafkan di registry Windows dengan perintah RegSvr32 dari menu Run di Windows.

MENGINSTAL FLEXCODE SDK DI DELPHI
Untuk penggunaan di Delphi, maka diperlukan langkah tambahan yaitu instalasi component Delphi. Sebelum menginstal, pastikan contoh
program VB6 dapat dijalankan. Setelah itu lakukan langkah-langkah sebagai berikut :
1.
Buka Delphi 7, masuk ke menu Component \ Install
Component
2.
Buka tab Into new package dan isi Unit file name dengan path
file component FlexCodeSDK.pas (1), serta isi Package file
name dengan path file DPK yang baru misalnya
C:\programfiles\Borland\Delphi7\Lib\dcluser.dpk (2).

Tekan tombol OK jika sudah selesai.


3.
Saat keluar window Confirm, tekan tombol Yes. Keluar window Information, tekan tombol
OK. Keluar window Package flexcode.dpk tekan icon Install.


4.
Tab component FlexCode SDK akan tampil sebagai 3 icon yaitu Reg, Ver dan Img. Dan
component ini sudah siap untuk digunakan.






FINGERSPOT WEBSITE & ONLINE SUPPORT
Untuk informasi & bantuan teknis, silahkan kirimkan email ke :
Informasi umum
: info@fingerspot.com
Layanan teknis
: support@fingerspot.com
Online Support
: www.fingerspot.com
Atau kunjungi website Fingerspot di www.fingerspot.com

Informasikan nomor seri U.are.U yang Anda miliki beserta dengan kode verifikasi dan kode aktivasi yang terdapat di sampul CD Instalasi
FlexCode SDK dalam pelayanan purna jual di atas.