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 + Score de Risque + Capture de document + Signature électronique exécute le selfie, la capture de document et la signature en une seule session.
Les parcours disponibles dépendent du flux configuré pour votre intégration. Consultez les Produits pour la correspondance complète produit → flux → capacité.
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
processIdviaonSuccesslorsque le journey se termine.
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.
É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
- 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
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) | Requis par l'interface delegate ; non utilisé dans une intégration Unico API |
onSuccess(result) | Requis dans une intégration Unico API. Journey terminé 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
- 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 est requisLa caméra s'ouvre avec un webAppToken, donc le SDK exige onSuccess : sans lui, il échoue avec l'erreur 74001. AcessoBioSelfieDelegate déclare onSuccess comme optionnel, donc le compilateur ne le vérifie pas, et une signature qui ne correspond pas à l'exemple ci-dessus compile et échoue de la même manière. Copiez la signature exactement comme indiqué.
É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 webAppToken :
Le webAppToken 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 ; appelezopen(self, webAppToken:).onCameraFailed(message)— la préparation de la caméra a échoué (ErrorPrepareest une extension deErrorBio).
- 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 { }
Pour la gestion complète du résultat, voir Réception du résultat.