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 :

Lit la configuration du flux fournie lors de l'initialisation.
Orchestre la séquence des captures requises pour le flux (selfie, document, signature).
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 AcessoBioListener

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

Méthode	Quand elle est appelée
`onErrorAcessoBio(errorBio)`	Une erreur s'est produite pendant l'opération du SDK
`onUserClosedCameraManually()`	L'utilisateur a fermé la caméra manuellement
`onSystemClosedCameraTimeoutSession()`	La limite de durée de session a été atteinte — voir Limites de session
`onSystemChangedTypeCameraTimeoutFaceInference()`	La limite de durée d'inférence faciale a été atteinte — bascule vers la capture manuelle — voir Limites de session

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

Étape 2 — Implémenter iAcessoBioSelfie

iAcessoBioSelfie gère les callbacks du résultat de capture du parcours :

Méthode	Description
`onSuccessSelfie(result)`	Image capturée avec succès — retourne `ResultCamera` pour les appels REST API ultérieurs
`onSuccess(result)`	Flux WebApp complété avec succès — retourne `SuccessResult` avec un `processId` utilisé pour interroger les résultats de validation
`onErrorSelfie(errorBio)`	Échec de la capture — retourne un `ErrorBio` avec les détails de l'erreur

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

Étape 3 — Appeler prepareCamera

Avec unicoCheckCamera initialisé et les deux listeners implémentés, appelez prepareCamera en passant la configuration du SDK, un CameraListener et votre web_app_token :

Où obtenir le 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 — la caméra est prête ; appelez open en passant le cameraListener et votre web_app_token.
onCameraFailed — la préparation de la caméra a échoué ; gérez le message d'erreur.

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);
  }
});

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