Parcours utilisateur

Les parcours utilisateur sont des sessions de capture multi-étapes orchestrées par le SDK en conjonction avec le flux configuré. Par exemple, un flux avec Détection de Vie + Classification du risque de fraude + Capture de document + Signature électronique exécute le selfie, la capture de document et la signature en une seule session.

Cas d'usage

Les parcours disponibles dépendent du flux configuré pour votre intégration. Consultez les Cas d'usage pour la correspondance complète cas d'usage → flux → capacité.

Fonctionnement

Le SDK :

1. Lit la configuration du flux fournie lors de l'initialisation.
2. Orchestre la séquence des captures requises pour le flux (selfie, document, signature).
3. Retourne un objet résultat pour chaque étape de capture.

L'orchestration est entièrement gérée par le SDK — vous n'avez pas besoin d'implémenter la séquence des étapes dans votre application.

Démarrer un parcours utilisateur

Étape 1 — Implémenter AcessoBioManagerDelegate

AcessoBioManagerDelegate gère les callbacks du cycle de vie du SDK. Implémentez les quatre méthodes obligatoires :

Méthode	Quand elle est appelée
onErrorAcessoBioManager(error)	Une erreur s'est produite lors du fonctionnement du SDK
onUserClosedCameraManually()	L'utilisateur a fermé manuellement la caméra
onSystemClosedCameraTimeoutSession()	La limite de session de 40 secondes a été atteinte
onSystemChangedTypeCameraTimeoutFaceInference()	Aucun visage détecté pendant 13 secondes — bascule en capture manuelle

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

Méthodes delegate obligatoires

Les quatre méthodes delegate ci-dessus doivent être créées dans votre projet (même sans logique). Sinon, le projet ne compilera pas correctement.

Étape 2 — Implémenter AcessoBioSelfieDelegate

Redéfinissez les méthodes pour gérer les callbacks du résultat de capture du parcours :

Méthode	Description
onSuccessSelfie(result)	Image capturée avec succès — retourne SelfieResult pour les appels REST API ultérieurs
onSuccess(result)	Flux WebApp complété avec succès — retourne un processId utilisé pour consulter les résultats de validation
onErrorSelfie(errorBio)	Capture échouée — retourne un ErrorBio avec les détails de l'erreur

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

Étape 3 — Appeler prepareSelfieCamera et open

Appelez prepareSelfieCamera en passant la configuration SDK. Lorsque la caméra est prête, l'événement onCameraReady est déclenché — ouvrez la caméra via la méthode open(), en passant le web_app_token :

web_app_token

Le web_app_token est le champ process.webAppToken retourné par POST /client/v1/process lors de la création du processus sur votre backend. Voir Créer un processus.

• onCameraReady(cameraOpener) — la caméra est prête ; appelez open(self, webAppToken:).
• onCameraFailed(message) — la préparation de la caméra a échoué (ErrorPrepare est une extension de 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 { }

Pour la gestion complète du résultat, voir Réception du résultat.