उपयोगकर्ता या त्राएं
उपयोगकर्ता यात्राएं (User Journeys) बहु-चरणीय कैप्चर सत्र हैं जिन्हें SDK कॉन्फ़िगर किए गए फ़्लो के साथ मिलकर संचालित करता है। उदाहरण के लिए, लाइवनेस + जोखिम स्कोर + Document Capture + Electronic Signature वाला फ़्लो एकल सत्र में सेल्फी, दस्तावेज़ कैप्चर और हस्ताक्षर निष्पादित करता है।
उपलब्ध यात्राएं आपके इंटीग्रेशन के लिए कॉन्फ़िगर किए गए फ़्लो पर निर्भर करती हैं। उत्पाद → फ़्लो → क्षमता की पूरी मैपिंग के लिए उत्पाद देखें।
SDK:
- इनिशियलाइज़ेशन के दौरान प्रदान किए गए फ़्लो कॉन्फ़िगरेशन को पढ़ता है।
- फ़्लो के लिए आवश्यक कैप्चर के क्रम (सेल्फी, दस्तावेज़, हस्ताक ्षर) को व्यवस्थित करता है।
- जब journey पूर्ण होता है तो
onSuccessके माध्यम सेprocessIdवापस किया जाता है।
ऑर्केस्ट्रेशन पूरी तरह से SDK द्वारा संभाली जाती है — आपको अपने ऐप में चरण अनुक्रम लागू करने की आवश्यकता नहीं है।
चरण 1 — AcessoBioManagerDelegate लागू करें
AcessoBioManagerDelegate SDK lifecycle callbacks को संभालता है। चार अनिवार्य विधियां लागू करें:
| विधि | जब यह कॉल की जाती है |
|---|---|
onErrorAcessoBioManager(error) | SDK संचालन के दौरान त्रुटि हुई |
onUserClosedCameraManually() | उपयोगकर्ता ने मैन्युअल रूप से कैमरा बंद किया |
onSystemClosedCameraTimeoutSession() | 40-सेकंड session सीमा पहुंच गई |
onSystemChangedTypeCameraTimeoutFaceInference() | 13 सेकंड तक कोई चेहरा नहीं पहचाना — manual capture पर स्विच |
- 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
ऊपर की सभी चार delegate विधियां आपके project में बनाई जानी चाहिए (चाहे बिना किसी logic के भी)। अन्यथा, project सफलतापूर्वक compile नहीं होगा।
चरण 2 — AcessoBioSelfieDelegate लागू करें
यात्रा कैप्चर परिणाम कॉलबैक संभालने के लिए विधियों को override करें:
| विधि | विवरण |
|---|---|
onSuccessSelfie(result) | delegate इंटरफेस के लिए आवश्यक; Unico API इंटीग्रेशन में उपयोग नहीं किया जाता |
onSuccess(result) | Unico API इंटीग्रेशन में आवश्यक है। Journey सफलतापूर्वक पूर्ण हुआ — सत्यापन परिणाम क्वेरी करने के लिए उपयोग किया जाने वाला processId लौटाता है |
onErrorSelfie(errorBio) | कैप्चर विफल — error details के साथ ErrorBio लौटाता है |
- 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 आवश्यक हैकैमरा webAppToken के साथ खुलता है, इसलिए SDK को onSuccess की आवश्यकता होती है: इसके बिना, यह error 74001 के साथ विफल हो जाता है। AcessoBioSelfieDelegate onSuccess को optional के रूप में घोषित करता है, इसलिए compiler इसे check नहीं करता, और ऊपर दिए गए उदाहरण से मेल न खाने वाला सिग्नेचर भी compile हो जाता है और उसी तरह विफल होता है। सिग्नेचर को ऊपर दिखाए अनुसार बिल्कुल वैसे ही कॉपी करें।
चरण 3 — prepareSelfieCamera और open कॉल करें
SDK config पास करते हुए prepareSelfieCamera कॉल करें। जब कैमरा तैयार होता है, onCameraReady event trigger होता है — open() विधि के माध्यम से कैमरा खोलें, webAppToken पास करते हुए:
webAppToken वह process.webAppToken फ़ील्ड है जो आपके backend पर प्रक्रिया बनाते समय POST /client/v1/process द्वारा वापस किया जाता है। प्रक्रिया बनाएं देखें।
onCameraReady(cameraOpener)— कैमरा तैयार है;open(self, webAppToken:)कॉल करें।onCameraFailed(message)— कैमरा तैयारी विफल रही (ErrorPrepareErrorBioका extension है)।
- 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 { }
पूर्ण परिणाम हैंडलिंग के लिए, परिणाम प्राप्त करना देखें।