How to Use the Fingerprint Module Interface in WizarPOS Terminals

From wizarPOS
Revision as of 00:02, 7 January 2024 by Simon (talk | contribs)

Adding Required Permissions

Manifest File Configuration:

  • Add the following permission to your application's manifest file:'<uses-permission android:name="android.permission.CLOUDPOS_FINGERPRINT" />'
  • Ensure that permissions are correctly set in the manifest file to avoid operational issues with the fingerprint module.

Using Crossmatch Fingerprint Module

SDK and Documentation:

  • To develop applications compatible with the Crossmatch fingerprint module, download the necessary SDK and documentation.
  • Basic SDK (TCS1FingerPrintSDK):
    • Use this SDK for basic operations like fingerprint input and image acquisition.
  • Advanced SDK (U.are.U SDK):
    • Utilize this SDK for more complex functions like fingerprint comparison or compression.
    • Note: The U.are.U SDK should not be used for fingerprint input. Specifically, the 'Reader' class from this SDK is not applicable for input purposes in your application.
    • It is crucial to integrate the appropriate SDK based on your application’s requirements.
Files to download Description
TCS1FingerPrintSDK Crossmatch fingerprint basic demo and javadoc API
TCS1FingerPrintSDK-U.are.U Crossmatch fingerprint UareU demo and javadoc API

WizarPOS fingerprint

Specification

You can get WizarPOS FP spec here.

API document

Please find com.cloudpos.fingerprint from java api doc.

  • Compare ISO 2005 template, please use method compare, compareByFormat and identify;
  • Compare ANSI 378 template, please use method compareByFormat(byte[] arryBuffer1, int format1, byte[] arryBuffer2, int format2);
  • Convert between ISO 2005 and ANSI 378 template format, please use convertFormat(byte[] dataBuffer, int srcFormat, int outFormat).

API Demo

Please consult the apidemo from Samples

Distinguish different fingerprint modules

There is a property called wp.fingerprint.model. If value is tuzhengbig, it is WizarPOS FP module; if value is crossmatch, it is Crossmatch fingerprint module. The code snippet is as follows:

    String prop = getProperty("wp.fingerprint.model","");
        if (prop.equalsIgnoreCase("none")) {
            showNormalDialog("tips", "No fingerprint module.");
        } else if (prop.equalsIgnoreCase("tuzhengbig")) {
           //WizarPOS FP
        } else if (prop.equalsIgnoreCase("crossmatch")) {
           //Crossmatch FP
        }    
    public static String getProperty(String key, String defaultValue) {
        String value = defaultValue;
        try {
            Class<?> c = Class.forName("android.os.SystemProperties");
            Method get = c.getMethod("get", String.class, String.class);
            value = (String)(get.invoke(c, key, defaultValue ));
        } catch (Exception e) {
            e.printStackTrace();
        }finally {
            return value;
        }
    }

Demos work success in any fingerprint module device:

Description Download Release Time
Get ISO fingerprint, then convert it to ANSI, compare the ISO and ANSI fingerprint, run in different fingerprint module device demo for ISO and ANSI fingerprint 2023-10-18