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

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

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

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

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

SDK:

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

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

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

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

AcessoBioListener SDK लाइफसाइकल कॉलबैक को संभालता है। चार अनिवार्य विधियाँ लागू करें:

विधि	कब बुलाई जाती है
onErrorAcessoBio(errorBio)	SDK संचालन के दौरान कोई त्रुटि हुई
onUserClosedCameraManually()	उपयोगकर्ता ने कैमरा मैन्युअल रूप से बंद किया
onSystemClosedCameraTimeoutSession()	सत्र समय सीमा पहुँच गई — देखें सत्र सीमाएँ
onSystemChangedTypeCameraTimeoutFaceInference()	चेहरा अनुमान समय सीमा पहुँच गई — मैन्युअल कैप्चर पर स्विच करता है — देखें सत्र सीमाएँ

Kotlin

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

Java

AcessoBioListener callback = new AcessoBioListener() {
  @Override
  public void onErrorAcessoBio(ErrorBio errorBio) { }

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

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

iAcessoBioSelfie यात्रा कैप्चर परिणाम कॉलबैक को संभालता है:

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

Kotlin

val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie {
  override fun onSuccessSelfie(result: ResultCamera?) { }
  override fun onSuccess(result: SuccessResult) { }
  override fun onErrorSelfie(errorBio: ErrorBio?) { }
}

Java

iAcessoBioSelfie cameraListener = new iAcessoBioSelfie() {
  @Override
  public void onSuccessSelfie(ResultCamera result) { }

  @Override
  public void onSuccess(SuccessResult result) { }

  @Override
  public void onErrorSelfie(ErrorBio errorBio) { }
};

चरण 3 — prepareCamera कॉल करें

unicoCheckCamera इनिशियलाइज़ और दोनों लिस्नर लागू होने के बाद, SDK कॉन्फ़िग, एक CameraListener और अपना webAppToken पास करते हुए prepareCamera कॉल करें:

webAppToken

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

• onCameraReady — कैमरा तैयार है; cameraListener और अपना webAppToken पास करते हुए open कॉल करें।
• onCameraFailed — कैमरा तैयारी विफल; त्रुटि संदेश संभालें।

Kotlin

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

Java

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

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