CheckUserIdentity (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Specific Mobile functions

Phone management functions

CheckUserIdentity

Presentation

Example

Application in the background: Specific case from Android 10

See also

Phone management functions

CheckUserIdentity (Function)

In french: VérifieIdentitéUtilisateur

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 his mobile phone. It is not possible to capture and save 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.
- Versions 23 and later
  the "Facial recognition" feature of iPhone X.
  New in version 23
  the "Facial recognition" feature of iPhone X.
  the "Facial recognition" feature of iPhone X.
Versions 23 and later
This feature is available from Android 6.0 (api level 23).
New in version 23
This feature is available from Android 6.0 (api level 23).
This feature is available from Android 6.0 (api level 23).

Versions 23 and later

This function is now available for Android applications.

New in version 23

This function is now available for Android applications.

Example

CheckUserIdentity("Vérification de l'identité pour déblocage", Authentification)

// Procédure de vérification
PROCÉDURE Authentification(nEtat is int, sMessageErreur is string)

SWITCH nEtat
CASE cuiAuthenticated
Info("Authentification OK")
CASE cuiAuthenticationFailure
Error("Echec de l'authentification: " + sMessageErreur)
CASE cuiAuthenticationUnavailable
Error("Authentification indisponible")
CASE cuiCustomAuthentication
mdp is string
// Saisie de commentaires par l'utilisateur dans un champ multiligne
SWITCH Input("Entrez le mot de passe: ", mdp)
// OK
CASE 1:
// Annuler
CASE 0:
END
END

Syntax

CheckUserIdentity(<Message> , <WLanguage procedure> [, <Button caption>])

<Message>: Character string (with quotes)

Message that will be displayed to the user.

If this string is a multiline string, only the first line will be visible in the identification popup.
This parameter is ignored during a facial recognition.

<WLanguage procedure>: Procedure name

Name of the Procedure WLanguage (also called "callback") called at the end of the user authentication. This procedure has the following format:

PROCEDURE <Nom de la procédure> (<Etat>, <Message d'erreur>)

where:
<Status> is an Integer constant indicating the authentication status:
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
cuiAuthenticated The user was properly authenticated.
cuiAuthenticationFailure The authentication failed.
<Error message> is a character string containing the system error message in case of authentication failure (cuiAuthenticationFailure constant). Otherwise, this parameter corresponds to an empty string.

<Button caption>: Optional character string (with quotes)

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.

Remarks

Versions 25 and later

Application in the background: Specific case from Android 10

From Android 10, it is no longer possible to open a window when the application is in the background.

CheckUserIdentity can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

See Android 10: Behavior of applications in the background for more details.

New in version 25

Application in the background: Specific case from Android 10

From Android 10, it is no longer possible to open a window when the application is in the background.

CheckUserIdentity can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

See Android 10: Behavior of applications in the background for more details.

Application in the background: Specific case from Android 10

From Android 10, it is no longer possible to open a window when the application is in the background.

CheckUserIdentity can open a window. If this function is used while the application is in the background, a fatal error will occur.

Tips:

It is possible to determine if the application is in the background using InBackgroundMode.
If an application needs to interact with the user while it is in the background, the solution is to display a notification (via the Notification type). The application will be brought back to the foreground when the notification is clicked, if the ActivateApplication property is set to True. You can also open a window from the procedure passed to the ActionClick property.

See Android 10: Behavior of applications in the background for more details.

Component: wd260android.aar