Fehlerbehandlung

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

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

@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

REST-API-Fehlercodes

Die obigen Codes sind SDK-Callback-Fehler. REST-API-Fehlercodes (HTTP-Statusfamilien) sind separat unter API-Referenz > Fehlercodes dokumentiert.