安装

添加依赖项并配置包管理器

步骤 1 — 配置内容安全策略（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 正常运行的必要条件。

步骤 2 — 安装软件包

Web SDK 可通过 npm 包或 CDN 获取。

npm
yarn
CDN

npm install unico-webframe

yarn add unico-webframe

下载 SDK 并将其导入到您的项目中：

下载版本 3.23.7

步骤 3 — 导入 SDK

安装完成后，将 SDK 导入到您的项目中。

从 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 版本	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（请参阅旧版表格）

同时下载 SDK 的 AI 文件：models.zip。

公共路径

所有额外文件必须托管在项目中可公开访问的位置，以便 Web 访问。