Fehlerbehandlung

Die gesamte Fehlerbehandlung des Flutter SDK ist in diesem Abschnitt zentralisiert. Die Callbacks onErrorUnico, onErrorSelfie und onErrorDocument empfangen ein UnicoError-Objekt, das getCode() und getDescription() bereitstellt.

Error codes

Code	Beschreibung
`73001`	Ungültiger Kontext
`73002`	Keine Berechtigung zum Öffnen der Kamera erteilt
`73003`	Mindest-API ist 21 (LOLLIPOP)
`73004`	Implementierungs-Interface-Callback `iAcessoBioSelfie` nicht gefunden
`73005`	Implementierungs-Interface-Callback `iAcessoBioDocument` nicht gefunden
`73006`	Kamera kann auf Emulatoren nicht geöffnet werden
`73100`	Keine Internetverbindung möglich
`73200`	Bitte geben Sie den Namen der JSON-Datei an
`73202`	JSON-Datei konnte nicht geparst werden
`73300`	Unico-Authentifizierungsobjekt konnte nicht abgerufen werden
`73301`	Objekt konnte nicht geparst werden
`73302`	Unico-Token nicht gefunden
`73303`	Aktueller Host ist nicht registriert
`73400`	Kamera konnte nicht initialisiert werden
`73500`	Sitzungstoken konnte nicht abgerufen werden — Dienstantwortfehler
`73501`	Objekt konnte nicht geparst werden
`73502`	Sitzungstoken konnte nicht abgerufen werden
`73701`	Aktiver Liveness-Import nicht gefunden
`73702`	Aktives Liveness im Produktionsmodus konnte nicht initialisiert werden
`73703`	Aktive Liveness-Sitzung konnte nicht abgerufen werden
`73704`	Der Benutzer hat die Abbrechen-Schaltfläche gedrückt und die Sitzung nicht abgeschlossen
`73705`	Die Sitzung wurde nicht erfolgreich durchgeführt und kein FaceScan wurde generiert
`73706`	Kamerazugriff verweigert — Benutzer hat die Berechtigung explizit verweigert oder Geräterichtlinie blockiert sie
`73707`	Die Sitzung wurde abgebrochen, weil die App beendet wurde, in den Ruhezustand wechselte, eine OS-Benachrichtigung eintraf oder sie in den Hintergrund verlagert wurde
`73708`	Die Sitzung wurde abgebrochen, weil sich das Gerät im Querformat befindet
`73709`	Die Sitzung wurde abgebrochen, weil sich das Gerät im umgekehrten Hochformat befindet
`73710`	Die Sitzung wurde abgebrochen, weil der Benutzer sie nicht innerhalb des vorgesehenen Zeitlimits abschließen konnte
`73712`	Die Sitzung wurde aufgrund von Speicherdruck abgebrochen / App außerhalb der Produktion erfordert Netzwerk
`73713`	Die Sitzung wurde abgebrochen, weil Ihr Schlüssel erneut validiert werden muss
`73714`	Die Sitzung wurde abgebrochen, weil der vom Entwickler konfigurierte Verschlüsselungsschlüssel nicht gültig war
`73715`	Die Sitzung wurde abgebrochen, weil nicht alle Führungsbilder konfiguriert waren
`73716`	Die Sitzung wurde abgebrochen, weil das SDK die Kamera auf diesem Gerät nicht starten konnte
`73717`	Die Sitzung wurde abgebrochen, weil sich der Benutzer in einem gesperrten Zustand befand
`73718`	Unbekannter und unerwarteter Fehler bei der normalen Nutzung nativer APIs
`73719`	Die Sitzung wurde abgebrochen, weil der Benutzer den Untertextlink des Bereitschaftsbildschirms gedrückt hat
`73800`	Verschlüsselter Schlüssel konnte nicht erstellt werden

Offizieller Fehlerkatalog

Die obigen Codes spiegeln den Flutter SDK-Katalog wider. Der offizielle plattformübergreifende Fehlercodekatalog ist unter API-Referenz > Fehlercodes verfügbar.

Handling the callback

@override
void onErrorUnico(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
  // handle error
}

Lifecycle callbacks

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

onUserClosedCameraManually() — Benutzer hat die Kamera manuell geschlossen.
onSystemClosedCameraTimeoutSession() — Sitzung ist aufgrund eines Timeouts abgelaufen (Standard 40 s, Minimum 40 s).
onSystemChangedTypeCameraTimeoutFaceInference() — Gesichtserkennung hat den Schwellenwert von 13 s überschritten; die Aufnahme wechselt in den manuellen Modus.