Aller au contenu principal

Gestion des erreurs

Toute la gestion des erreurs du SDK Flutter est centralisée dans cette section. Les callbacks onErrorUnico, onErrorSelfie et onErrorDocument reçoivent un objet UnicoError exposant getCode() et getDescription().

Codes d'erreur
CodeDescription
73001Contexte invalide
73002Permission d'ouverture de la caméra non accordée
73003L'API minimale requise est 21 (LOLLIPOP)
73004Impossible de trouver l'implémentation du callback d'interface iAcessoBioSelfie
73005Impossible de trouver l'implémentation du callback d'interface iAcessoBioDocument
73006Impossible d'ouvrir la caméra sur les émulateurs
73100Impossible de se connecter à Internet
73200Veuillez indiquer le nom du fichier JSON
73202Impossible d'analyser le fichier JSON
73300Impossible d'obtenir l'objet d'authentification unico
73301Impossible d'analyser l'objet
73302Impossible de trouver le token unico
73303L'hôte actuel n'est pas enregistré
73400Impossible d'initialiser la caméra
73500Impossible d'obtenir le token de session — erreur de réponse du service
73501Impossible d'analyser l'objet
73502Impossible d'obtenir le token de session
73701Impossible de trouver l'import de liveness actif
73702Impossible d'initialiser le liveness actif en mode production
73703Impossible d'obtenir la session de liveness actif
73704L'utilisateur a appuyé sur le bouton d'annulation et n'a pas complété la session
73705La session ne s'est pas terminée avec succès et aucun FaceScan n'a été généré
73706Accès à la caméra refusé — l'utilisateur a explicitement refusé l'autorisation ou la politique de l'appareil la bloque
73707La session a été annulée en raison de la fermeture de l'application, de la mise en veille, d'une notification OS ou du passage en arrière-plan
73708La session a été annulée car l'appareil est en mode paysage
73709La session a été annulée car l'appareil est en mode portrait inversé
73710La session a été annulée car l'utilisateur n'a pas pu la terminer dans le délai imparti
73712La session a été annulée en raison d'une pression mémoire / l'application hors production nécessite un réseau
73713La session a été annulée car votre clé doit être à nouveau validée
73714La session a été annulée car la clé de chiffrement configurée par le développeur n'était pas valide
73715La session a été annulée car toutes les images de guidage n'étaient pas configurées
73716La session a été annulée car le SDK n'a pas pu démarrer la caméra sur cet appareil
73717La session a été annulée car l'utilisateur était dans un état de verrouillage
73718Erreur inconnue et inattendue lors de l'utilisation normale des API natives
73719La session a été annulée car l'utilisateur a appuyé sur le texte du sous-titre de l'écran de préparation
73800Impossible de construire la clé chiffrée
Catalogue officiel des erreurs

Les codes ci-dessus reflètent le catalogue du SDK Flutter. Le catalogue officiel des codes d'erreur multi-plateformes est disponible dans API Reference > Error codes.

Gestion du callback
@override
void onErrorUnico(UnicoError error) {
final code = error.getCode();
final description = error.getDescription();
// handle error
}
Callbacks du cycle de vie

En plus de onErrorUnico, le SDK déclenche également :

  • onUserClosedCameraManually() — l'utilisateur a fermé la caméra manuellement.
  • onSystemClosedCameraTimeoutSession() — la session a expiré en raison d'un délai d'attente (par défaut 40 s, minimum 40 s).
  • onSystemChangedTypeCameraTimeoutFaceInference() — la détection faciale a dépassé le seuil de 13 s ; la capture passe en mode manuel.