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:

Liest die während der Initialisierung bereitgestellte Flow-Konfiguration.
Orchestriert die für den Flow erforderliche Aufnahmesequenz (Selfie, Dokument, Unterschrift).
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 — AcessoBioListener implementieren

AcessoBioListener verarbeitet die Lebenszyklus-Callbacks des SDK. Implementieren Sie die vier obligatorischen Methoden:

Methode	Wann sie aufgerufen wird
`onErrorAcessoBio(errorBio)`	Ein Fehler ist während des SDK-Betriebs aufgetreten
`onUserClosedCameraManually()`	Der Benutzer hat die Kamera manuell geschlossen
`onSystemClosedCameraTimeoutSession()`	Das Sitzungszeitlimit wurde erreicht — siehe Sitzungslimits
`onSystemChangedTypeCameraTimeoutFaceInference()`	Das Zeitlimit für die Gesichtserkennung wurde erreicht — wechselt zur manuellen Aufnahme — siehe Sitzungslimits

Kotlin
Java

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

AcessoBioListener callback = new AcessoBioListener() {
  @Override
  public void onErrorAcessoBio(ErrorBio errorBio) { }

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

Schritt 2 — iAcessoBioSelfie implementieren

iAcessoBioSelfie verarbeitet die Rückruf-Callbacks des Journey-Aufnahmeergebnisses:

Methode	Beschreibung
`onSuccessSelfie(result)`	Bild erfolgreich aufgenommen — gibt `ResultCamera` für nachfolgende REST-API-Aufrufe zurück
`onSuccess(result)`	WebApp-Flow erfolgreich abgeschlossen — gibt `SuccessResult` mit einer `processId` zurück, die zum Abfragen der Validierungsergebnisse verwendet wird
`onErrorSelfie(errorBio)`	Aufnahme fehlgeschlagen — gibt ein `ErrorBio` mit Fehlerdetails zurück

Kotlin
Java

val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie {
  override fun onSuccessSelfie(result: ResultCamera?) { }
  override fun onSuccess(result: SuccessResult) { }
  override fun onErrorSelfie(errorBio: ErrorBio?) { }
}

iAcessoBioSelfie cameraListener = new iAcessoBioSelfie() {
  @Override
  public void onSuccessSelfie(ResultCamera result) { }

  @Override
  public void onSuccess(SuccessResult result) { }

  @Override
  public void onErrorSelfie(ErrorBio errorBio) { }
};

Schritt 3 — prepareCamera aufrufen

Mit initialisiertem unicoCheckCamera und beiden implementierten Listenern rufen Sie prepareCamera auf und übergeben dabei die SDK-Konfiguration, einen CameraListener und Ihr web_app_token:

Woher kommt das 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 — Kamera ist bereit; rufen Sie open auf und übergeben Sie den cameraListener und Ihr web_app_token.
onCameraFailed — Kameravorbereitung fehlgeschlagen; verarbeiten Sie die Fehlermeldung.

Kotlin
Java

unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
  override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
    cameraOpener?.open(cameraListener, "your_web_app_token")
  }

  override fun onCameraFailed(message: String?) {
    Log.e(TAG, message)
  }
})

unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
  @Override
  public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
    cameraOpener.open(cameraListener, "your_web_app_token");
  }

  @Override
  public void onCameraFailed(String message) {
    Log.e(TAG, message);
  }
});

Die vollständige Ergebnisverarbeitung finden Sie unter Ergebnis empfangen.