दस्तावेज़ कैप्चर
पहचान दस्तावेजों का कैप्चर। SDK उपयोगकर्ता को दस्तावेज़ स्थित करने में सहायता के लिए एक फ्रेम प्रस्तुत करता है; स्थित करने के बाद, उपयोगकर्ता फ़ोटो कैप्चर करने के लिए बटन क्लिक करता है।
SDK कैप्चर की जा रही सामग्री पर किसी भी प्रकार का सत्यापन नहीं करता।
| फ्रे म | विवरण |
|---|---|
DocumentCameraTypes.CPF | CPF कैप्चर करें |
DocumentCameraTypes.CNH | खुला CNH कैप्चर करें |
DocumentCameraTypes.CNH_FRENTE | CNH का सामने का भाग कैप्चर करें |
DocumentCameraTypes.CNH_VERSO | CNH का पीछे का भाग कैप्चर करें |
DocumentCameraTypes.RG_FRENTE | RG का सामने का भाग कैप्चर करें |
DocumentCameraTypes.RG_VERSO | RG का पीछे का भाग कैप्चर करें |
DocumentCameraTypes.RG_FRENTE_NOVO | नए RG का सामने का भाग कैप्चर करें |
DocumentCameraTypes.RG_VERSO_NOVO | नए RG का पीछे का भाग कैप्चर करें |
DocumentCameraTypes.OTHERS("descrição") | किसी अन्य दस्तावेज़ के लिए सामान्य फ्रेम |
यदि आपको किसी ऐसे दस्तावेज़ को कैप्चर करना है जिसके लिए कोई विशिष्ट फ्रेम नहीं है (जैसे, RNE), तो DocumentCameraTypes.OTHERS("description") का उपयोग करें — एक सामान्य, आयताकार फ्रेम जिसे किसी भी कैप्चर के लिए उपयोग किया जा सकता है।
समर्थित दस्तावेज़ प्रकारों की पूरी सूची के लिए, देखें API Reference > Enums।
कैप्चर क्षेत्र को अनुकूलित करने के लिए अपने एप्लिकेशन में फ्रेम के आकार को कॉन्फ़िगर करने की अनुशंसा की जाती है।
ग्रिड घटकों (Bootstrap, Material-UI, आदि) वाले design systems द्वारा फ्रेम कार्यक्षमता प्रभावित हो सकती है। इस जोखिम को कम करने के लिए, फ्रेम (id="box-camera") को ऐसी जगह रखें जहाँ वह अनावश्यक CSS नियम न उठाए।
- Desktop
- Mobile
फ्रेम को उसके आयामों को सीमित करने के लिए एक parent element में wrap करें:
<div class="container">
<div id="box-camera"></div>
</div>
.container {
width: 800px;
height: 600px;
position: relative;
}
उपयोगकर्ता के चेहरे को फ्रेम करना आसान बनाने के लिए उचित height-to-width ratio बनाए रखें।
ब्राउज़र के developer mode के माध्यम से स्क्रीन का आकार बदलने से जुड़े परीक्षण अपेक्षित रूप से काम नहीं करेंगे। इसके बजाय अपनी ब्राउज़र विंडो का आकार सीधे बदलें।
Web Mobile views के लिए, कंप्यूटर विज़न एल्गोरिदम के साथ समस्याओं से बचने के लिए कैप्चर फ्रेम को डिवाइस स्क्रीन का 100% (100vw/100vh) कवर करना चाहिए। क्षैतिज या ऊर्ध्वाधर स्क्रॉलिंग से बचें — एक modal का उपयोग करने से यह कम हो जाता है।
ब्राउज़र developer mode का उपयोग करके परीक्षण काम नहीं करता — ब्राउज़र द्वारा उपयोग किया जाने वाला कैमरा desktop कैमरा है, जिसका रिज़ॉल्यूशन mobile device कैमरे से बिल्कुल अलग है। डिवाइस पर सीधे परीक्षण करें।
चरण 1 — callback ऑब्जेक्ट लागू करें
Web SDK open() को पास किए गए callback ऑब्जेक्ट का उपयोग success और error इवेंट को संभालने के लिए करता है। दोनों हैंडलर अनिवार्य हैं:
| हैंडलर | कब कॉल होता है |
|---|---|
on.success(obj) | कैप्चर सफलतापूर्वक पूरा हुआ — base64 और encrypted के साथ एक ऑब्जेक्ट प्राप्त करता है |
on.error(error) | सेशन के दौरान एक त्रुटि हुई — एक ErrorBio प्राप्त करता है |
const callback = {
on: {
success: (obj) => {
console.log(obj.base64);
console.log(obj.encrypted);
},
error: (error) => {
console.error(error);
}
}
};
callback ऑब्जेक्ट अनिवार्य है। यदि ठीक से लागू नहीं किया गया (दोनों success और error इवेंट कवर करते हुए), तो SDK एक अपवाद उठाता है जो, यदि संभाला नहीं गया, उपयोगकर्ता के कंसोल में प्रदर्शित होता है।
चरण 2 — कैमरा बनाएं और दस्तावेज़ session तैयार करें
कैमरा instance बनाएं और UnicoConfig और वांछित DocumentCameraTypes पास करते हुए prepareDocumentCamera को कॉल करें:
const unicoCamera = unicoCameraBuilder.build();
const config = new UnicoConfig()
.setHostname("<YOUR_HOSTNAME>")
.setHostKey("<YOUR_HOST_KEY>");
unicoCamera.prepareDocumentCamera(
config,
DocumentCameraTypes.CNH
).then(cameraOpener => {
cameraOpener.open(callback);
}).catch(error => {
console.error(error);
});
पूर्ण परिणाम हैंडलिंग के लिए, देखें परिणाम प्राप्त करना।