Manejo de errores

Todo el manejo de errores del SDK de Android está centralizado en esta sección. El callback onErrorAcessoBio recibe un objeto ErrorBio con code y description.

Códigos de error

Código	Mensaje predeterminado	Cuándo ocurre	Manejo recomendado
`AUTH_FAILED`	SDK authentication failed	Clave SDK inválida o expirada	Valide las credenciales con el equipo de Onboarding
`CAMERA_PERMISSION_DENIED`	Camera permission denied	El usuario denegó el permiso de cámara	Dirija al usuario a la configuración de la app
`LIVENESS_FAILED`	Liveness check failed	La imagen no pasó la validación de vida	Solicite una nueva captura
`NETWORK_ERROR`	Network error during capture	Conectividad insuficiente	Solicite reconexión
`SDK_NOT_INITIALIZED`	SDK not initialized	Se llamó a la captura antes de init	Asegúrese de que init sea llamado en Application/onCreate

Códigos de error del SDK

Los códigos anteriores cubren los errores principales de los callbacks del SDK. Los códigos de error de la REST API (familias de estado HTTP) están documentados por separado en Referencia de API > Códigos de error.

Manejo del callback

Kotlin
Java

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 */ }
  }
}

@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 ciclo de vida

Además de onErrorAcessoBio, el SDK también activa:

onUserClosedCameraManually() — el usuario cerró la cámara manualmente.
onSystemClosedCameraTimeoutSession() — la sesión expiró por tiempo de espera.
onSystemChangedTypeCameraTimeoutFaceInference() — no se detectó ningún rostro durante 13 segundos; el SDK cambia a captura manual.