Allows you to check the real identity of the current user via biometrics check.
If the authentication is available, a message asks the user to authenticate himself. Then, the WLanguage authentication procedure is called.
Caution: This function only verifies the user's identity via the data stored on the mobile phone. It is not possible to capture the user's fingerprint.
Remarks:
This function is available from iOS version 8.0. The project must be compiled with Xcode 6 (or later). This function is using: - the "Touch ID" feature of iPhones 5S and later versions.
- the "Facial recognition" feature of iPhone X.
This feature is available from Android 6.0 (api level 23).
CheckUserIdentity("Check the identity for unlocking", Authentication)
// Check procedure
PROCEDURE Authentication(nStatus is int, sErrorMessage is string)
SWITCH nStatus
CASE cuiAuthenticated
Info("Authentication OK")
CASE cuiAuthenticationFailure
Error("Authentication failure: " + sErrorMessage)
CASE cuiAuthenticationUnavailable
Error("Authentication not available")
CASE cuiCustomAuthentication
pwd is string
// Comments typed by the user in a multiline control
SWITCH Input("Enter the password: ", pwd)
// OK
CASE 1:
// Cancel
CASE 0:
END
END
Syntax
CheckUserIDentity(<Message> , <WLanguage procedure> [, <Button caption>])
<Message>: Character string
Message that will be displayed to the user.
<WLanguage procedure>: Procedure name
Name of the WLanguage procedure ("callback") called once the user authentication is complete. This procedure has the following format:
PROCEDURE <Procedure name> (<Status>, <Error message>)
where:
- is an Integer constant indicating the authentication status:
| |
| cuiAuthenticated | The user was properly authenticated. |
| cuiAuthenticationFailure | The authentication failed. |
| cuiAuthenticationUnavailable | The authentication feature is not available or it was disabled by the user. |
| cuiCustomAuthentication | The user wants to authenticate by using a password: the application will have to manage this authentication manually |
- is a character string containing the system error message if the authentication fails (cuiAuthenticationFailure constant). Otherwise, this parameter corresponds to an empty string.
<Button caption>: Optional character string
Default caption of authentication button (displayed on the button for typing the password). This button is used to connect without checking the biometrics. This button is displayed as soon as the first failure occurs.
Component: wd280android.aar