DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions spécifiques Mobile / Fonctions de gestion du téléphone
  • Application en arrière-plan : Spécificité à partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
VérifieIdentitéUtilisateur (Fonction)
En anglais : CheckUserIdentity
Permet de vérifier l'identité réelle de l'utilisateur en cours par vérification biométrique.
Si l'authentification est disponible, un message est affiché à l'utilisateur lui demandant de s'authentifier. La procédure WLangage d'authentification est ensuite appelée.
Attention : Cette fonction vérifie uniquement l'identité de l'utilisateur via les données enregistrées sur son mobile. Il n'est pas possible d'enregistrer l'empreinte digitale de l'utilisateur.
Remarques :
  • iPhone/iPadWidget IOSMac Catalyst Cette fonction est disponible à partir de la version 8.0 de iOS. Il est nécessaire de compiler le projet avec Xcode 6 (ou supérieur). Cette fonction utilise :
    • la fonctionnalité "Touch ID" des iPhones 5S et versions supérieures.
    • la fonctionnalité "Reconnaissance faciale" des iPhone X.
  • Android Cette fonctionnalité est disponible à partir de la version de Android 6.0 (api level 23).
Exemple
VérifieIdentitéUtilisateur("Vérification de l'identité pour déblocage", Authentification)

// Procédure de vérification
PROCÉDURE INTERNE Authentification(nEtat est un entier, sMessageErreur est une chaîne)

SELON nEtat
CAS viuAuthentifié
// Authentification OK.
CAS viuEchecAuthentification
Erreur("Échec de l'authentification : " + sMessageErreur)
// On réessaye.
VérifieIdentitéUtilisateur("Vérification de l'identité pour déblocage", Authentification)
CAS viuAuthentificationManuelle,viuAuthentificationIndisponible
// Saisie d'un mot de passe dans ce cas.
mdp est une chaîne
SELON Saisie("Entrez le mot de passe : ", mdp)
CAS 1 : // OK
SI mdp ="1234" ALORS
// Authentification OK.
SINON
Erreur("Mot de passe incorrect")
// On réessaye.
VérifieIdentitéUtilisateur("Vérification de l'identité pour déblocage", Authentification)
FIN
CAS 0 : // Annuler
Ferme()
FIN
FIN
FIN
Syntaxe
VérifieIdentitéUtilisateur(<Message> , <Procédure WLangage> [, <Libellé du bouton>])
<Message> : Chaîne de caractères
Message qui sera affiché à l'utilisateur.
iPhone/iPadWidget IOSMac Catalyst
  • Si cette chaîne est multiligne, seule la première ligne sera visible dans la popup d'identification.
  • Lors d'une reconnaissance faciale, ce paramètre est ignoré.
<Procédure WLangage> : Nom de procédure
Nom de la procédure WLangage (également nommée "callback") appelée à la fin de l'authentification de l'utilisateur. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure> (<Etat>, <Message d'erreur>)
où :
  • est une constante de type entier indiquant l'état de l'authentification :
    viuAuthentificationIndisponibleLa fonctionnalité d'authentification est indisponible ou désactivée par l'utilisateur.
    viuAuthentificationManuelleL'utilisateur a demandé à s'authentifier en utilisant un mot de passe : l'application devra gérer cette authentification manuellement
    viuAuthentifiéL'utilisateur s'est authentifié correctement.
    viuEchecAuthentificationL'authentification a échoué.
  • est une chaîne de caractères contenant le message d'erreur système en cas d'échec de l'authentification (constante viuEchecAuthentification). Dans le cas contraire, ce paramètre correspond à une chaîne vide.
<Libellé du bouton> : Chaîne de caractères optionnelle
Libellé du bouton d'authentification par défaut (affiché sur le bouton de saisie du mot de passe). Ce bouton permet de se connecter sans la vérification biométrique. Ce bouton apparaît dès le premier échec.
Remarques
Android

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction VérifieIdentitéUtilisateur peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Composante : wd290android.aar
Version minimum requise
  • Version 20
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 13/10/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale