Getting Started

复制一个包含安装步骤和此插件的完整 Markdown 指南的设置提示。

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-verisoul`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/verisoul/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

安装

您可以使用我们的 AI 助手设置来安装插件。使用以下命令将 Capgo 技能添加到您的 AI 工具中：

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-verisoul` plugin in my project.

如果您更喜欢手动设置，请运行以下命令安装插件，并按照以下平台特定的说明进行操作：

npm install @capgo/capacitor-verisoul
npx cap sync

配置Verisoul

Call configure() 在您的应用程序启动时只调用一次。使用 sandbox 用于测试和 prod 用于生产流量。

import { Verisoul } from '@capgo/capacitor-verisoul';

await Verisoul.configure({
  environment: 'prod',
  projectId: 'YOUR_PROJECT_ID',
});

获取会话 ID

当 Verisoul 收集足够的本地信号后，请请求会话 ID 并将其发送到您的后端。您的后端应调用 Verisoul 的服务器端 API 进行风险评估。

const { sessionId } = await Verisoul.getSessionId();

await fetch('/api/risk/verisoul', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ sessionId }),
});

在帐号变更时重置

调用 reinitialize() 当用户上下文发生变化时，例如注销后登录另一个帐号时。

await Verisoul.reinitialize();

安卓触摸信号

复制到剪贴板

await Verisoul.recordTouchEvent({
  x: 120,
  y: 240,
  action: 'down',
});

平台设置

iOS设置涵盖 App Attest 权限说明。
Android设置涵盖 Verisoul Maven 仓库和权限。

继续从 Getting Started

如果您正在使用 Getting Started 来集成 Verisoul 会话，连接它与 @capgo/capacitor-verisoul 为API概述 iOS设置为App Attest说明 Android设置为Gradle设置使用@capgo/capacitor-verisoul 插件教程