This is an old revision of the document!


Server API

API that can enable server matching or controls the device from the BioStar application.

Warning


BioMini&Image SDK License Error : Invalid Verification!
This is the Suprema license key you need in order to use server matching feature.
Once you receive “UFLisense.lic” file, you need to activate them using “activate_lic.exe” file.
Suprema ID sales team will give you further instruction on this.
Suprema ID: sales_id@supremainc.com

Once you activate the license, please copy this “UFLisense.lic” file into BioStar 2 device SDK folder.
The BioStar 2 device SDK version you received, you will find “example” folder there.
Please try to copy the license file to example folder (Example > cli > csharp > common > lib > x86) and see if can use server matching.

  • BS2_SetServerMatchingHandler: Configures the server matching handler.
  • BS2_VerifyUser: Transfers user information mapped to the card or user ID authentication results to the device.
  • BS2_IdentifyUser: Transfers user information mapped to the fingerprint authentication results to the device.
  • BS2_VerifyUserEx: Transfers user information mapped to the card or user ID authentication results to the device. (Applies only for v2.4 FW group)
  • BS2_IdentifyUserEx: Transfers user information mapped to the fingerprint authentication results to the device. (Applies only for v2.4 FW group)
typedef void (*OnVerifyUser)(uint32_t deviceId, uint16_t seq, uint8_t isCard, uint8_t cardType, const uint8_t* data, uint32_t dataLen);
typedef void (*OnIdentifyUser)(uint32_t deviceId, uint16_t seq, uint8_t format, const uint8_t* templateData, uint32_t templateSize);

1. OnVerifyUser
Callback function that is called when the BioStar application needs to distinguish whether the card or user ID matches.

2. OnIdentifyUser
Callback function that is called when the BioStar application needs to distinguish whether the fingerprint matches.