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 + Risiko-Score + Dokumentenerfassung + Elektronische Unterschrift Selfie, Dokumentaufnahme und Unterschrift in einer einzigen Sitzung durch.
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.
Das SDK:
- Liest die während der Initialisierung bereitgestellte Flow-Konfiguration.
- Orchestriert die für den Flow erforderliche Aufnahmesequenz (Selfie, Dokument, Unterschrift).
- Gibt eine
processIdüberonSuccesszurück, wenn die Journey abgeschlossen ist.
Die Orchestrierung wird vollständig vom SDK übernommen — Sie müssen die Schrittfolge nicht in Ihrer App implementieren.
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
- Objective-C
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() { }
}
@implementation ViewController: UIViewController
- (void)viewDidLoad {
[super viewDidLoad];
unicoCheck = [[AcessoBioManager alloc]initWithViewController:self];
}
- (void)onErrorAcessoBioManager:(ErrorBio *)error { }
- (void)onSystemChangedTypeCameraTimeoutFaceInference { }
- (void)onSystemClosedCameraTimeoutSession { }
- (void)onUserClosedCameraManually { }
@end
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) | 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 |
- Swift
- Objective-C
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {
func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
@interface ViewController: UIViewController <AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate>
@end
@implementation ViewController
- (void)onSuccessSelfie:(SelfieResult *)result { }
- (void)onSuccess:(SuccessResult *)result { }
- (void)onErrorSelfie:(ErrorBio *)errorBio { }
@end
onSuccess ist erforderlichDie 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:
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 Sieopen(self, webAppToken:)auf.onCameraFailed(message)— Kameravorbereitung fehlgeschlagen (ErrorPrepareist eine Erweiterung vonErrorBio).
- Swift
- Objective-C
@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!) { }
- (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.