Gestion des erreurs

La gestion de toutes les erreurs du SDK Android est centralisée dans cette section. Le callback onErrorAcessoBio reçoit un objet ErrorBio avec code (Int) et description (String).

Gestion du callback

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case 73002: /* camera permission denied — redirect to app settings */ break;
    case 73006: /* running on emulator — physical device required */ break;
    case 73100: /* no internet connection */ break;
    default: /* generic error handling */
  }
}

Callbacks de cycle de vie

En plus de onErrorAcessoBio, 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épassé.
• onSystemChangedTypeCameraTimeoutFaceInference() — aucun visage détecté pendant 13 secondes ; le SDK bascule en capture manuelle.

Codes d'erreur

Tous les codes d'erreur proviennent de l'enum UnicoException et sont transmis via ErrorBio(code, message). Le champ message contient la chaîne exacte du SDK — ne la modifiez pas et ne la localisez pas.

Code	Message	Description
73001	Context invalid	Contexte Android invalide transmis au SDK
73002	Did not grant permission to open camera	L'utilisateur a refusé la permission d'accès à la caméra
73003	The lest API is 21(LOLLIPOP	Le niveau d'API de l'appareil est inférieur au minimum requis (API 21)
73004	Could not find implementation interface callback iAcessoBioSelfie	Interface iAcessoBioSelfie non implémentée
73005	Could not find implementation interface callback iAcessoBioDocument	Interface iAcessoBioDocument non implémentée
73006	Unable to open camera on emulators	Le SDK ne fonctionne pas sur les émulateurs — utilisez un appareil physique
73007	Unknown and unexpected error in WebApp…	Erreur générique de la WebApp (caméra, stockage, sécurité, réseau)
73100	Unable to connect to internet.	Pas de connexion internet disponible
73200	Please inform the config object or json file name	Objet de configuration ou fichier JSON non fourni
73202	Unable to parse json file	Le fichier de configuration JSON est malformé
73204	Unable to initialize the SDK, please configure the environment on setEnviroment method of build	setEnvironment() n'a pas été appelé avant l'initialisation
73300	Unable to get unico authentication object	Échec de la récupération de l'objet d'authentification
73301	Unable to parse object	Échec de l'analyse de la réponse d'authentification
73302	Could not find the unico token	Token d'authentification Unico introuvable
73303	Current host is not registered	Identifiant de bundle non enregistré dans la SDK Key
73400	Could not initialize camera	Échec de l'initialisation de la caméra
73701	Could not find active liveness import	Module de détection de vie active introuvable
73703	Unable to get active liveness session	Échec de l'obtention d'une session de détection de vie
73718	The Session was cancelled because of an unknown and unexpected error…	Erreur interne inconnue lors de la session
73721	The Session can't be performed: attempts limit exceeded.	Session annulée — limite de tentatives de capture atteinte
73722	The Session can't be performed: face alignment timeout.	Session annulée — délai d'alignement du visage dépassé
73726	An error happened during video recording	Erreur d'enregistrement vidéo lors de la détection de vie
73727	No actions found in a video	Aucune action de détection de vie détectée dans la vidéo
73740	The user pressed the do not consent button and did not complete the Session.	L'utilisateur a refusé le consentement
73800	Could not build encrypted key.	Échec de la création du JWT chiffré
73801	The Session of SDK was cancelled because of an unknown and unexpected error.	Erreur interne inconnue lors de la session SDK
73802	The Session was cancelled because of an unknown and unexpected error…	Session annulée — champs JWT requis manquants
73900	Erro ao analisar imagem	Erreur lors de l'analyse de l'image capturée
73901	É necessário implementar a interface AcessoBioListener	Interface AcessoBioListener non implémentée
73902	É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.	La valeur de setTimeoutSession doit être supérieure à 40 secondes
73903	Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.	Fichier de configuration corrompu — vérifiez le fichier JSON et réessayez
73904	Erro ao finalizar processo	Erreur lors de la finalisation du processus de capture
73905	Unable to open document camera	La caméra de document n'a pas pu être ouverte
73906	Document type uninformed	Type de document non spécifié
74001	onSuccess: not implemented when using open:webAppToken:	Callback onSuccess non implémenté pour le User Journey
74100	Could not prepare SDK-S	Échec de la préparation des composants du SDK
74101	No URL token was provided.	Aucun token d'URL fourni pour le parcours
74102	Environment type was not specified.	Environnement (PROD/UAT) non configuré
737120	Unable to initialize liveness	L'activité de détection de vie n'a pas pu être initialisée
737220	Capture could not start	Le processus de capture n'a pas pu démarrer
737320	Transaction could not start	La transaction n'a pas pu être initiée
737321	The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.	Erreur générique du fournisseur de session — réessayez

Codes d'erreur de l'API REST

Les codes ci-dessus sont des erreurs de callback du SDK. Les codes d'erreur de l'API REST (familles de statuts HTTP) sont documentés séparément sur Référence API > Codes d'erreur.