Fehlerbehandlung

Die gesamte Fehlerbehandlung für das Android-SDK ist in diesem Abschnitt zusammengefasst. Der onErrorAcessoBio-Callback empfängt ein ErrorBio-Objekt mit code und description.

Fehlercodes

Code	Kategorie	Standardmeldung	Wann tritt er auf	Empfohlene Behandlung
AUTH_FAILED	Authentifizierung	SDK-Authentifizierung fehlgeschlagen	Ungültiger oder abgelaufener SDK-Schlüssel	Anmeldedaten mit dem Onboarding-Team validieren
CAMERA_PERMISSION_DENIED	Berechtigung	Kameraberechtigung verweigert	Benutzer hat Kameraberechtigung abgelehnt	Benutzer zu den App-Einstellungen weiterleiten
LIVENESS_FAILED	Aufnahme	Liveness-Prüfung fehlgeschlagen	Bild hat die Liveness-Validierung nicht bestanden	Neue Aufnahme anfordern
NETWORK_ERROR	Netzwerk	Netzwerkfehler während der Aufnahme	Unzureichende Konnektivität	Neuverbindung anfordern
SDK_NOT_INITIALIZED	Lebenszyklus	SDK nicht initialisiert	Aufnahme vor der Initialisierung aufgerufen	Sicherstellen, dass init in Application/onCreate aufgerufen wird

SDK-Fehlercodes

Die obigen Codes decken die primären SDK-Callback-Fehler ab. REST-API-Fehlercodes (HTTP-Statusfamilien) sind separat unter API-Referenz > Fehlercodes dokumentiert.

Callback verarbeiten

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

Lebenszyklus-Callbacks

Zusätzlich zu onErrorAcessoBio löst das SDK auch folgende Callbacks aus:

• onUserClosedCameraManually() — Benutzer hat die Kamera manuell geschlossen.
• onSystemClosedCameraTimeoutSession() — Sitzung aufgrund eines Timeouts abgelaufen.
• onSystemChangedTypeCameraTimeoutFaceInference() — kein Gesicht für 13 Sekunden erkannt; das SDK wechselt zur manuellen Aufnahme.