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.

如果您prefer手动设置，安装插件并运行以下命令，然后遵循以下平台特定的说明：

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();

Android触摸信号

在Android上，向您的应用程序传递触摸事件以收集Verisoul触摸模式。

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

平台设置

Android设置继续从Getting Started
继续从Getting Started Section titled “Platform setup”

Section titled “Keep going from Getting Started”

如果您正在使用入门以集成Verisoul会话,连接它与 @capgo/capacitor-verisoul 有关API概述 iOS设置有关App Attest说明 Android设置有关Gradle设置使用@capgo/capacitor-verisoul 有关插件教程