Zum Hauptinhalt springen

Fehlerbehandlung

Die gesamte Fehlerbehandlung für das iOS-SDK ist in diesem Abschnitt zentralisiert. Der Callback onErrorAcessoBioManager empfängt ein ErrorBio-Objekt, das getCode() und getDescription() bereitstellt.

Fehlercodes
CodeBeschreibung
73000Die Sitzung wurde aufgrund eines unbekannten und unerwarteten Fehlers abgebrochen. Das Unico Check SDK nutzt eine Vielzahl von iOS-APIs, darunter Kamera, Speicher, Sicherheit, Netzwerk und mehr — dies ist ein allgemeiner Auffangfehler.
73001Kontext ungültig
73003Die API-Version muss 13 oder neuer sein
73006Kamera kann auf Emulatoren nicht geöffnet werden
73100Keine Internetverbindung möglich
73200Die JSON-Datei unico_sdk wurde nicht gefunden
73202Die JSON-Datei unico_sdk konnte nicht geladen werden
73203AcessoBioConfigDataSource konnte nicht geladen werden
73204Das SDK konnte nicht initialisiert werden — konfigurieren Sie die Umgebung über setEnvironment beim Build
73300Das Unico-Authentifizierungsobjekt konnte nicht abgerufen werden
73301Das Unico-Authentifizierungsobjekt konnte nicht geparst werden
73302Der Unico-Token wurde nicht gefunden
73701Der Active-Liveness-Import wurde nicht gefunden
73702Active Liveness konnte im Produktionsmodus nicht initialisiert werden
73703Die Active-Liveness-Sitzung konnte nicht abgerufen werden
73704Der Benutzer hat die Schaltfläche „Abbrechen" gedrückt und die Sitzung nicht abgeschlossen
73705Die Sitzung wurde nicht erfolgreich durchgeführt und es wurde kein FaceScan generiert
73706Kamerazugriff verweigert — der Benutzer hat die Berechtigung explizit verweigert oder eine Geräterichtlinie blockiert sie
73707Die Sitzung wurde abgebrochen, weil die App beendet wurde, sich im Ruhezustand befand, eine OS-Benachrichtigung erschien oder die App in den Hintergrund gewechselt hat
73708Die Sitzung wurde abgebrochen, weil sich das Gerät im Querformat befindet
73709Die Sitzung wurde abgebrochen, weil sich das Gerät im umgekehrten Hochformat befindet
73710Die Sitzung wurde abgebrochen, weil der Benutzer sie nicht innerhalb des vorgesehenen Zeitlimits abschließen konnte
73711Die Sitzung wurde aufgrund von Speicherdruck abgebrochen
73712Die Sitzung wurde abgebrochen, weil Ihre App nicht in der Produktion ist und eine Netzwerkverbindung benötigt
73713Die Sitzung wurde abgebrochen, weil Ihr Schlüssel erneut validiert werden muss
73714Die Sitzung wurde abgebrochen, weil der vom Entwickler konfigurierte Verschlüsselungsschlüssel ungültig war
73715Die Sitzung wurde abgebrochen, weil nicht alle Anleitungsbilder konfiguriert wurden
73716Die Sitzung wurde abgebrochen, weil das SDK die Kamera auf diesem Gerät nicht starten konnte
73717Die Sitzung wurde abgebrochen, weil der Benutzer gesperrt war
73718Unbekannter und unerwarteter Fehler bei der normalen Nutzung von iOS-APIs
73719Die Sitzung wurde abgebrochen, weil der Benutzer den Untertextverweis auf dem Bereitschaftsbildschirm gedrückt hat
73720Die Sitzung wurde nicht verarbeitet
73721Die Sitzung kann nicht durchgeführt werden: Versuchslimit überschritten
73722Die Sitzung kann nicht durchgeführt werden: Zeitüberschreitung bei der Gesichtsausrichtung
73730Eine Active-Liveness-Sitzung konnte nicht initialisiert werden — unbekannter Lizenzfehler
73731Eine Active-Liveness-Sitzung konnte nicht initialisiert werden — Lizenz abgelaufen
73800Verschlüsselter Schlüssel konnte nicht erstellt werden
Offizieller Fehlerkatalog

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

Lifecycle-Callbacks

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

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