उपयोगकर्ता यात्राएं

उपयोगकर्ता यात्राएं (User Journeys) बहु-चरणीय कैप्चर सत्र हैं जिन्हें SDK कॉन्फ़िगर किए गए फ़्लो के साथ मिलकर संचालित करता है। उदाहरण के लिए, लाइवनेस + धोखाधड़ी जोखिम वर्गीकरण + Fraud Risk Classification + Document Capture + Electronic Signature वाला फ़्लो एकल सत्र में सेल्फी, दस्तावेज़ कैप्चर और हस्ताक्षर निष्पादित करता है।

उपयोग के मामले

उपलब्ध यात्राएं आपके इंटीग्रेशन के लिए कॉन्फ़िगर किए गए फ़्लो पर निर्भर करती हैं। उपयोग के मामले → फ़्लो → क्षमता की पूरी मैपिंग के लिए उपयोग के मामले देखें।

यह कैसे काम करता है

SDK:

1. इनिशियलाइज़ेशन के दौरान प्रदान किए गए फ़्लो कॉन्फ़िगरेशन को पढ़ता है।
2. फ़्लो के लिए आवश्यक कैप्चर के क्रम (सेल्फी, दस्तावेज़, हस्ताक्षर) को व्यवस्थित करता है।
3. जब journey पूर्ण होता है तो onSuccess के माध्यम से processId वापस किया जाता है। सेल्फी चरण के लिए, onSuccessSelfie के माध्यम से इमेज डेटा (base64 / encrypted) भी वापस किया जाता है। दस्तावेज़ और हस्ताक्षर कैप्चर SDK द्वारा आंतरिक रूप से प्रसंस्कृत किए जाते हैं — प्रति चरण कोई कलाकृति क्लाइंट को उजागर नहीं की जाती।

ऑर्केस्ट्रेशन पूरी तरह से SDK द्वारा संभाली जाती है — आपको अपने ऐप में चरण अनुक्रम लागू करने की आवश्यकता नहीं है।

उपयोगकर्ता यात्रा प्रारंभ करना

चरण 1 — AcessoBioManagerDelegate लागू करें

AcessoBioManagerDelegate SDK lifecycle callbacks को संभालता है। चार अनिवार्य विधियां लागू करें:

विधि	जब यह कॉल की जाती है
onErrorAcessoBioManager(error)	SDK संचालन के दौरान त्रुटि हुई
onUserClosedCameraManually()	उपयोगकर्ता ने मैन्युअल रूप से कैमरा बंद किया
onSystemClosedCameraTimeoutSession()	40-सेकंड session सीमा पहुंच गई
onSystemChangedTypeCameraTimeoutFaceInference()	13 सेकंड तक कोई चेहरा नहीं पहचाना — manual capture पर स्विच

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

अनिवार्य delegate विधियां

ऊपर की सभी चार delegate विधियां आपके project में बनाई जानी चाहिए (चाहे बिना किसी logic के भी)। अन्यथा, project सफलतापूर्वक compile नहीं होगा।

चरण 2 — AcessoBioSelfieDelegate लागू करें

यात्रा कैप्चर परिणाम कॉलबैक संभालने के लिए विधियों को override करें:

विधि	विवरण
onSuccessSelfie(result)	छवि सफलतापूर्वक कैप्चर हुई — बाद के REST API calls के लिए SelfieResult लौटाता है
onSuccess(result)	Journey सफलतापूर्वक पूर्ण हुआ — सत्यापन परिणाम क्वेरी करने के लिए उपयोग किया जाने वाला processId लौटाता है
onErrorSelfie(errorBio)	कैप्चर विफल — error details के साथ ErrorBio लौटाता है

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

चरण 3 — prepareSelfieCamera और open कॉल करें

SDK config पास करते हुए prepareSelfieCamera कॉल करें। जब कैमरा तैयार होता है, onCameraReady event trigger होता है — open() विधि के माध्यम से कैमरा खोलें, webAppToken पास करते हुए:

webAppToken

webAppToken वह process.webAppToken फ़ील्ड है जो आपके backend पर प्रक्रिया बनाते समय POST /client/v1/process द्वारा वापस किया जाता है। प्रक्रिया बनाएं देखें।

• onCameraReady(cameraOpener) — कैमरा तैयार है; open(self, webAppToken:) कॉल करें।
• onCameraFailed(message) — कैमरा तैयारी विफल रही (ErrorPrepare ErrorBio का extension है)।

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

पूर्ण परिणाम हैंडलिंग के लिए, परिणाम प्राप्त करना देखें।