Benutzer-Journeys

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

Anwendungsfälle

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

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 für jeden Aufnahmeschritt ein Ergebnisobjekt zurück.

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:

Methode	Wann 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

Swift

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() { }
}

Objective-C

@implementation ViewController: UIViewController
- (void)viewDidLoad {
    [super viewDidLoad];
    unicoCheck = [[AcessoBioManager alloc]initWithViewController:self];
}

- (void)onErrorAcessoBioManager:(ErrorBio *)error { }
- (void)onSystemChangedTypeCameraTimeoutFaceInference { }
- (void)onSystemClosedCameraTimeoutSession { }
- (void)onUserClosedCameraManually { }
@end

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:

Methode	Beschreibung
onSuccessSelfie(result)	Bild erfolgreich aufgenommen — gibt SelfieResult für nachfolgende REST-API-Aufrufe zurück
onSuccess(result)	WebApp-Flow 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

Swift

class ViewController: UIViewController, AcessoBioManagerDelegate,
  SelfieCameraDelegate, AcessoBioSelfieDelegate {

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

Objective-C

@interface ViewController: UIViewController <AcessoBioManagerDelegate,
  SelfieCameraDelegate, AcessoBioSelfieDelegate>
@end

@implementation ViewController
- (void)onSuccessSelfie:(SelfieResult *)result { }
- (void)onSuccess:(SuccessResult *)result { }
- (void)onErrorSelfie:(ErrorBio *)errorBio { }
@end

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 web_app_token:

web_app_token

Das web_app_token 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).

Swift

@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!) { }

Objective-C

- (IBAction)openCamera:(UIButton *)sender {
    [[unicoCheck build] prepareSelfieCamera:self config:[YourUnicoConfigClass new]];
}

- (void)onCameraReady:(id)cameraOpener {
    [cameraOpener open:self webAppToken:@"your_web_app_token"];
}

- (void)onCameraFailed:(ErrorPrepare *)message { }

Zur vollständigen Ergebnisverarbeitung, siehe Ergebnis empfangen.