监控数据采集

可选实现

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

将用户和流程元数据附加到采集会话，以便在 Unico 的监控和可观测性工具中进行关联。提供后，数据会随采集一并转发 — 不会改变 SDK 的采集行为或 API 响应。

PrepareInfo attributes

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

Implementation

创建一个 PrepareInfo 对象，并将其作为第三个参数传递给 prepareCamera。采集流程中的其他所有内容保持不变。

Kotlin

val extraData = PrepareInfo(
    externalUserId = "external_user_id",
    useCase = "use_case"
)

unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        cameraOpener?.open(cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
}, extraData)

Java

PrepareInfo extraData = new PrepareInfo("external_user_id", "flow_id");

unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
        cameraOpener.open(cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
}, extraData);