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 et description.

Codes d'erreur

Code	Message par défaut	Quand cela se produit	Gestion recommandée
AUTH_FAILED	SDK authentication failed	Clé SDK invalide ou expirée	Validez les identifiants avec l'équipe Onboarding
CAMERA_PERMISSION_DENIED	Camera permission denied	L'utilisateur a refusé l'autorisation de caméra	Dirigez l'utilisateur vers les paramètres de l'application
LIVENESS_FAILED	Liveness check failed	L'image n'a pas passé la validation de liveness	Demandez une nouvelle capture
NETWORK_ERROR	Network error during capture	Connectivité insuffisante	Demandez une reconnexion
SDK_NOT_INITIALIZED	SDK not initialized	Capture appelée avant l'initialisation	Assurez-vous que init est appelé dans Application/onCreate

Codes d'erreur du SDK

Les codes ci-dessus couvrent les principales 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.

Gestion du callback

Kotlin

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    "AUTH_FAILED" -> { /* handle authentication failure */ }
    "CAMERA_PERMISSION_DENIED" -> { /* redirect to app settings */ }
    "LIVENESS_FAILED" -> { /* prompt the user to try again */ }
    else -> { /* generic error handling */ }
  }
}

Java

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case "AUTH_FAILED": /* handle authentication failure */ break;
    case "CAMERA_PERMISSION_DENIED": /* redirect to app settings */ break;
    case "LIVENESS_FAILED": /* prompt the user to try again */ 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.