Liveness (बायोमेट्रिक सेल्फी)

एम्बेडेड liveness सत्यापन के साथ बायोमेट्रिक सेल्फी कैप्चर। SDK SmartFrames के माध्यम से जब तक बायोमेट्रिक रूप से वैध फ्रेम प्राप्त नहीं होती तब तक उपयोगकर्ता का मार्गदर्शन करता है और छवि को Base64 + JWT (JSON Web Token — आपके backend को REST API कॉल करने के लिए भेजा गया एक हस्ताक्षरित payload) के रूप में लौटाता है।

क्षमता

यह कैप्चर प्रकार Liveness क्षमता का उपयोग करता है। Liveness कैसे काम करता है इसकी अवधारणात्मक जानकारी के लिए, Liveness क्षमता पृष्ठ देखें।

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

SDK पूरे कैप्चर सत्र को प्रबंधित करता है:

1. SmartFrame ओवरले के साथ कैमरा खोलता है।
2. उपयोगकर्ता को फ्रेम के भीतर अपना चेहरा रखने के लिए मार्गदर्शन करता है।
3. Liveness को सत्यापित करता है — सत्र केवल तब पूरा होता है जब उपयोगकर्ता शारीरिक रूप से मौजूद हो।
4. base64 और encrypted (JWT) के साथ ResultCamera ऑब्जेक्ट लौटाता है।

Liveness कैप्चर प्रारंभ करना

चरण 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)	कैप्चर सफल हुई — base64 (पूर्वावलोकन) और encrypted (API के लिए JWT) के साथ ResultCamera लौटाता है
onErrorSelfie(errorBio)	कैप्चर विफल हुई — कोड और विवरण के साथ ErrorBio लौटाता है

टोकन समाप्ति

encrypted उत्पन्न करने और इसे API को सबमिट करने के बीच का अंतराल 10 मिनट से अधिक नहीं होना चाहिए।

Kotlin

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

Java

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

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

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

unicoCheckCamera प्रारंभीकृत होने और दोनों listeners लागू होने के बाद, SDK config (Initialization में बनाया गया UnicoConfig) और एक SelfieCameraListener पास करते हुए prepareCamera को कॉल करें:

• onCameraReady — कैमरा तैयार है; चरण 2 से selfieListener पास करते हुए open को कॉल करें।
• onCameraFailed — कैमरा तैयारी विफल हुई; त्रुटि संदेश को संभालें।

Kotlin

unicoCheckCamera
  .prepareCamera(UnicoConfig(), object : SelfieCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Selfie?) {
      cameraOpener?.open(selfieListener)
    }
    override fun onCameraFailed(message: String?) { }
  })

Java

unicoCheckCamera
  .prepareCamera(new UnicoConfig(), new SelfieCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Selfie cameraOpener) {
      cameraOpener.open(selfieListener);
    }

    @Override
    public void onCameraFailed(String message) { }
  });

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