Zum Hauptinhalt springen

Benutzer-Journeys

Markdown

Benutzer-Journeys sind mehrstufige Aufnahmesitzungen, die vom SDK in Verbindung mit dem konfigurierten Flow orchestriert werden. Zum Beispiel führt ein Flow mit Lebenderkennung + Risiko-Score + Dokumentenerfassung + Elektronische Unterschrift Selfie, Dokumentaufnahme und Unterschrift in einer einzigen Sitzung durch.

Produkte

Die verfügbaren Journeys hängen von dem für Ihre Integration konfigurierten Flow ab. Eine vollständige Zuordnung von Produkt → Flow → Funktion finden Sie unter Produkte.

Funktionsweise

Das SDK:

  1. Liest die während der Initialisierung bereitgestellte Flow-Konfiguration.
  2. Orchestriert die für den Flow erforderliche Aufnahmesequenz (Selfie, Dokument, Unterschrift).
  3. Gibt eine processId über onSuccess zurück, wenn die Journey abgeschlossen ist.

Die Orchestrierung wird vollständig vom SDK übernommen — Sie müssen die Schrittfolge nicht in Ihrer App implementieren.

Benutzer-Journey starten
Schritt 1 — AcessoBioManagerDelegate implementieren

AcessoBioManagerDelegate verwaltet die Lifecycle-Callbacks des SDKs. Implementieren Sie die vier obligatorischen Methoden:

MethodeWann sie aufgerufen wird
onErrorAcessoBioManager(error)Ein Fehler ist während des SDK-Betriebs aufgetreten
onUserClosedCameraManually()Der Benutzer hat die Kamera manuell geschlossen
onSystemClosedCameraTimeoutSession()Das 40-Sekunden-Sitzungslimit wurde erreicht
onSystemChangedTypeCameraTimeoutFaceInference()Kein Gesicht für 13 Sekunden erkannt — wechselt zur manuellen Aufnahme
class ViewController: UIViewController, AcessoBioManagerDelegate {
var unicoCheck: AcessoBioManager!

override func viewDidLoad() {
super.viewDidLoad()
unicoCheck = AcessoBioManager(viewController: self)
}

func onErrorAcessoBioManager(_ error: ErrorBio!) { }
func onUserClosedCameraManually() { }
func onSystemClosedCameraTimeoutSession() { }
func onSystemChangedTypeCameraTimeoutFaceInference() { }
}
Obligatorische Delegate-Methoden

Alle vier oben genannten Delegate-Methoden müssen in Ihrem Projekt erstellt werden (auch ohne Logik). Andernfalls wird das Projekt nicht erfolgreich kompiliert.

Schritt 2 — AcessoBioSelfieDelegate implementieren

Überschreiben Sie die Methoden, um die Rückruf-Callbacks des Journey-Aufnahmeergebnisses zu verarbeiten:

MethodeBeschreibung
onSuccessSelfie(result)Vom Delegate-Interface erforderlich; wird bei einer Unico API-Integration nicht verwendet
onSuccess(result)Erforderlich bei einer Unico API-Integration. Journey erfolgreich abgeschlossen — gibt eine processId zurück, die zum Abfragen der Validierungsergebnisse verwendet wird
onErrorSelfie(errorBio)Aufnahme fehlgeschlagen — gibt ein ErrorBio mit Fehlerdetails zurück
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {

func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
onSuccess ist erforderlich

Die Kamera öffnet sich mit einem webAppToken, daher erfordert das SDK onSuccess: ohne es schlägt es mit dem Fehler 74001 fehl. AcessoBioSelfieDelegate deklariert onSuccess als optional, sodass der Compiler es nicht prüft, und eine Signatur, die nicht dem obigen Beispiel entspricht, kompiliert und schlägt auf die gleiche Weise fehl. Übernehmen Sie die Signatur exakt wie gezeigt.

Schritt 3 — prepareSelfieCamera und open aufrufen

Rufen Sie prepareSelfieCamera mit der SDK-Konfiguration auf. Wenn die Kamera bereit ist, wird das Ereignis onCameraReady ausgelöst — öffnen Sie die Kamera über die Methode open() und übergeben Sie dabei das webAppToken:

webAppToken

Das webAppToken ist das Feld process.webAppToken, das von POST /client/v1/process zurückgegeben wird, wenn der Prozess in Ihrem Backend erstellt wird. Siehe Prozess erstellen.

  • onCameraReady(cameraOpener) — Kamera ist bereit; rufen Sie open(self, webAppToken:) auf.
  • onCameraFailed(message) — Kameravorbereitung fehlgeschlagen (ErrorPrepare ist eine Erweiterung von ErrorBio).
@IBAction func openCamera(_ sender: Any) {
unicoCheck.build().prepareSelfieCamera(self, config: YourUnicoConfigClass())
}

func onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
cameraOpener.open(self, webAppToken: "your_web_app_token")
}

func onCameraFailed(_ message: ErrorPrepare!) { }

Zur vollständigen Ergebnisverarbeitung, siehe Ergebnis empfangen.