监控数据采集

可选实现

监控数据采集是可选的。如果您采用它，仅 prepareSelfieCamera 调用会受到影响 — 采集流程中的其他所有步骤（初始化、回调、结果处理）保持不变。

完全不需要相机？

本页介绍 setSilentInfo，它仅在伴随 prepareSelfieCamera/prepareDocumentCamera 调用时才会生效。如果您希望在完全不打开相机会话的情况下进行静默验证（例如登录页面），请改用 initializeSDK + startSilentValidation——详见静默重新验证。两者可以在同一页面中同时使用。

将用户和流程元数据附加到采集会话，以便在 Unico 的监控和可观测性工具中进行关联，并使后端能够将其纳入本次交易的静默重新验证结果。提供后，数据会随采集一并转发，且不会改变 SDK 的采集行为——但会影响创建流程的响应：详见静默重新验证中的 silentAuth.result。

setSilentInfo parameters

参数	类型	必填	描述
`externalUserId`	`String`	✅	您系统中的用户标识符。传输前自动使用 SHA-256 进行哈希处理 — 从不以明文发送。
`useCase`	`String`	—	运行的流程或上下文的标识符（例如 `"account_opening"`、`"password_recovery"`）。以明文传输。

Implementation

在调用 prepareSelfieCamera 之前，在已构建的相机实例上调用 setSilentInfo。采集流程中的其他所有内容保持不变。

import { UnicoCheckBuilder, UnicoConfig, SelfieCameraTypes, SDKEnvironmentTypes } from "@acesso-io/unico-webframe";

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

const unicoCamera = new UnicoCheckBuilder()
  .setEnvironment(SDKEnvironmentTypes.UAT)
  .build();

unicoCamera.setSilentInfo("external_user_id", "flow_id");

await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);