---
title: Fehlerbehandlung
canonical: https://developer.unico.io/de/dual-api/developers/sdks-and-tools/android/error-handling
locale: de
generated_by: markdown-export
---

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

## Callback verarbeiten

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

## 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.

## Fehlercodes

Alle Fehlercodes stammen aus dem Enum `UnicoException` und werden über `ErrorBio(code, message)` übergeben. Das Feld `message` enthält die exakte SDK-Zeichenkette — bitte nicht ändern oder lokalisieren.

| Code | Meldung | Beschreibung |
|---|---|---|
| `73001` | `Context invalid` | Ungültiger Android-Kontext an das SDK übergeben |
| `73002` | `Did not grant permission to open camera` | Kameraberechtigung vom Benutzer verweigert |
| `73003` | `The lest API is 21(LOLLIPOP` | Das API-Level des Geräts liegt unter dem Mindestanforderung (API 21) |
| `73004` | `Could not find implementation interface callback iAcessoBioSelfie` | Interface `iAcessoBioSelfie` nicht implementiert |
| `73005` | `Could not find implementation interface callback iAcessoBioDocument` | Interface `iAcessoBioDocument` nicht implementiert |
| `73006` | `Unable to open camera on emulators` | Das SDK funktioniert nicht auf Emulatoren — physisches Gerät erforderlich |
| `73007` | `Unknown and unexpected error in WebApp…` | Generischer WebApp-Fehler (Kamera, Speicher, Sicherheit, Netzwerk) |
| `73100` | `Unable to connect to internet.` | Keine Internetverbindung verfügbar |
| `73200` | `Please inform the config object or json file name` | Konfigurationsobjekt oder JSON-Datei nicht angegeben |
| `73202` | `Unable to parse json file` | JSON-Konfigurationsdatei ist fehlerhaft |
| `73204` | `Unable to initialize the SDK, please configure the environment on setEnviroment method of build` | `setEnvironment()` wurde vor der Initialisierung nicht aufgerufen |
| `73300` | `Unable to get unico authentication object` | Authentifizierungsobjekt konnte nicht abgerufen werden |
| `73301` | `Unable to parse object` | Authentifizierungsantwort konnte nicht geparst werden |
| `73302` | `Could not find the unico token` | Unico-Authentifizierungstoken nicht gefunden |
| `73303` | `Current host is not registered` | Bundle-Bezeichner nicht in der SDK Key registriert |
| `73400` | `Could not initialize camera` | Kamerainitialisierung fehlgeschlagen |
| `73701` | `Could not find active liveness import` | Aktives Lebenderkennung-Modul nicht gefunden |
| `73703` | `Unable to get active liveness session` | Lebenderkennung-Sitzung konnte nicht abgerufen werden |
| `73718` | `The Session was cancelled because of an unknown and unexpected error…` | Unbekannter interner Sitzungsfehler |
| `73721` | `The Session can't be performed: attempts limit exceeded.` | Sitzung abgebrochen — Limit der Aufnahmeversuche erreicht |
| `73722` | `The Session can't be performed: face alignment timeout.` | Sitzung abgebrochen — Timeout bei der Gesichtsausrichtung |
| `73726` | `An error happened during video recording` | Videoaufzeichnungsfehler während der Lebenderkennung |
| `73727` | `No actions found in a video` | Keine Lebenderkennung-Aktionen im Video erkannt |
| `73740` | `The user pressed the do not consent button and did not complete the Session.` | Benutzer hat die Einwilligung verweigert |
| `73800` | `Could not build encrypted key.` | Verschlüsseltes JWT konnte nicht erstellt werden |
| `73801` | `The Session of SDK was cancelled because of an unknown and unexpected error.` | Unbekannter interner SDK-Sitzungsfehler |
| `73802` | `The Session was cancelled because of an unknown and unexpected error…` | Sitzung abgebrochen — erforderliche JWT-Felder fehlen |
| `73900` | `Erro ao analisar imagem` | Fehler bei der Analyse des aufgenommenen Bildes |
| `73901` | `É necessário implementar a interface AcessoBioListener` | Interface `AcessoBioListener` nicht implementiert |
| `73902` | `É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.` | Der Wert von `setTimeoutSession` muss größer als 40 Sekunden sein |
| `73903` | `Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.` | Beschädigte Konfigurationsdatei — prüfen Sie die JSON-Datei und versuchen Sie es erneut |
| `73904` | `Erro ao finalizar processo` | Fehler beim Abschließen des Aufnahmeprozesses |
| `73905` | `Unable to open document camera` | Dokumentkamera konnte nicht geöffnet werden |
| `73906` | `Document type uninformed` | Dokumenttyp nicht angegeben |
| `74001` | `onSuccess: not implemented when using open:webAppToken:` | Callback `onSuccess` nicht implementiert für User Journey |
| `74100` | `Could not prepare SDK-S` | SDK-Komponenten konnten nicht vorbereitet werden |
| `74101` | `No URL token was provided.` | Kein URL-Token für den Prozess angegeben |
| `74102` | `Environment type was not specified.` | Umgebung (`PROD`/`UAT`) nicht konfiguriert |
| `737120` | `Unable to initialize liveness` | Lebenderkennung-Aktivität konnte nicht initialisiert werden |
| `737220` | `Capture could not start` | Aufnahmeprozess konnte nicht gestartet werden |
| `737320` | `Transaction could not start` | Transaktion konnte nicht gestartet werden |
| `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.` | Generischer Sitzungsanbieterfehler — bitte erneut versuchen |

:::secondary[REST-API-Fehlercodes]
Die obigen Codes sind SDK-Callback-Fehler. REST-API-Fehlercodes (HTTP-Statusfamilien) sind separat unter [API-Referenz > Fehlercodes](/dual-api/developers/api-reference/error-codes) dokumentiert.
:::