--- title: Gestion des erreurs canonical: https://developer.unico.io/fr/dual-api/developers/sdks-and-tools/android/error-handling locale: fr generated_by: markdown-export --- 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 ```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 ```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 | :::secondary[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](/dual-api/developers/api-reference/error-codes). :::