इंस्टॉलेशन

डिपेंडेंसी जोड़ें और पैकेज मैनेजर कॉन्फ़िगर करें

चरण 1 — Content Security Policy (CSP) कॉन्फ़िगर करें

Web SDK सुरक्षा और प्रदर्शन के लिए Web Workers का उपयोग करता है। अपने CSP में निम्नलिखित कॉन्फ़िगरेशन जोड़ें:

<meta
  http-equiv="Content-Security-Policy"
  content="
      script-src 'self' 'unsafe-eval' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io;
      worker-src 'self' blob:;
      child-src 'self' blob:;
      style-src 'self' 'unsafe-inline' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      font-src 'self' https://fonts.gstatic.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      img-src 'self' data: blob: *.acesso.io *.unico.run *.unico.io *.unico.app;
      media-src 'self' data: *.acesso.io *.unico.run *.unico.io *.unico.app;
      script-src-elem 'self' 'unsafe-inline' blob: *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
      connect-src *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io"
/>

चेतावनी

यदि आपके एप्लिकेशन में CSP है, तो SDK के सही कामकाज को सुनिश्चित करने के लिए यह कॉन्फ़िगरेशन अनिवार्य है।

प्रत्येक निर्देश क्यों आवश्यक है

'unsafe-eval' (script-src) — लाइवनेस डिटेक्शन इंजन द्वारा WebAssembly को compile करने और runtime पर अपनी सुरक्षा routines को dynamically evaluate करने के लिए आवश्यक है।
'unsafe-inline' (style-src, script-src-elem) — SDK के inline styles और inline script bootstrapping के लिए आवश्यक है। इसे हटाने से capture UI टूट जाता है।
*.acesso.io — Unico का legacy infrastructure domain, assets और API calls के लिए अभी भी आवश्यक है।
*.unico.run / *.unico.io / *.unico.app — वर्तमान Unico service domains (CDN, API, और app subdomains)।
*.googleapis.com (script-src, style-src, script-src-elem, connect-src) — Google Fonts stylesheet (@font-face CSS via fonts.googleapis.com) और capture UI द्वारा उपयोग किए जाने वाले अन्य Google API resources को load करने के लिए आवश्यक है।
fonts.gstatic.com (font-src) — fonts.googleapis.com से लोड की गई स्टाइलशीट द्वारा संदर्भित Google Fonts की बाइनरी फ़ॉन्ट फ़ाइलें प्रदान करता है।
*.sentry.io — Unico, SDK error tracking के लिए Sentry का उपयोग करता है। error reporting calls को allow करने के लिए script-src और connect-src में आवश्यक है।
blob: (worker-src, child-src, script-src-elem) — आवश्यक है क्योंकि Web Workers और कुछ SDK sub-resources runtime पर Blob URLs के रूप में बनाए जाते हैं।

चरण 2 — पैकेज इंस्टॉल करें

Web SDK एक npm पैकेज या CDN के माध्यम से प्रदान किया जाता है।

npm
yarn
CDN

npm install unico-webframe

yarn add unico-webframe

SDK डाउनलोड करें और इसे अपने प्रोजेक्ट में import करें:

संस्करण 3.23.7 डाउनलोड करें

चरण 3 — SDK import करें

इंस्टॉलेशन के बाद, SDK को अपने प्रोजेक्ट में import करें।

npm से
CDN से

import {
  UnicoCheckBuilder,
  SelfieCameraTypes,
  UnicoThemeBuilder,
  DocumentCameraTypes,
  UnicoConfig,
  LocaleTypes
} from 'unico-webframe'

import {
  UnicoCheckBuilder,
  SelfieCameraTypes,
  UnicoThemeBuilder,
  DocumentCameraTypes,
  UnicoConfig,
  LocaleTypes
} from 'UnicoCheckBuilder.min.js'

चरण 4 — अतिरिक्त रिसोर्स फ़ाइलें डाउनलोड करें

Liveness कैप्चर करने के लिए अतिरिक्त रिसोर्स फ़ाइलें आवश्यक हैं। अपने SDK संस्करण से मेल खाती फ़ाइल डाउनलोड करें और इसे अपने प्रोजेक्ट में शामिल करें:

अपग्रेड चेकलिस्ट

रिसोर्स फ़ाइलें SDK के संस्करण से बंधी होती हैं। जब भी आप unico-webframe को अपग्रेड करें, आपको नीचे दी गई तालिका से मेल खाने वाले रिसोर्स को अवश्य फिर से डाउनलोड करना होगा — असंगत संस्करणों का उपयोग करने से liveness कैप्चर के दौरान runtime error आता है।

वैकल्पिक रूप से, SDK 3.18.0 से SDK initialization के समय इन फ़ाइलों को स्वचालित रूप से fetch कर सकता है, जिससे manual download की आवश्यकता समाप्त हो जाती है। setResourceDirectory विकल्प के लिए Initialization देखें।

SDK संस्करण	FaceTec संसाधन
3.23.7	9.7.114
3.23.3 → 3.23.6	9.7.107
3.23.0 → 3.23.1	9.7.102
3.22.6 → 3.22.7	9.7.100
3.22.5	9.7.99
3.22.3 → 3.22.4	9.7.98
3.22.2	9.7.96
3.22.1	9.7.93
3.22.0	9.7.90
3.21.3 → 3.21.4	9.7.85
3.21.2	9.7.82
3.21.1	9.7.80
3.20.10 → 3.21.0	9.7.76
3.20.9	9.7.75
3.20.8	9.7.73
3.20.7	9.7.68
3.20.5 → 3.20.6	9.7.65
3.20.3 → 3.20.4	9.7.64
3.20.2	9.7.63
3.20.1	9.7.61
3.20.0	9.7.55
3.19.0 → 3.19.3	9.7.45 → 9.7.51
3.18.x	9.6.92 → 9.7.41 (legacy तालिका देखें)

SDK के लिए AI फ़ाइलें भी डाउनलोड करें: models.zip.

Public path

सभी अतिरिक्त फ़ाइलें आपके प्रोजेक्ट के भीतर Web को दिखाई देने वाले एक public स्थान पर होस्ट होनी चाहिए।