Coleta de Dados de Monitoramento

Implementação opcional

A Coleta de Dados de Monitoramento é opcional. Se você a adotar, apenas a chamada prepareCamera é afetada — todas as outras etapas do fluxo de captura (inicialização, listeners, tratamento do resultado) permanecem inalteradas.

Anexe metadados de usuário e fluxo a uma sessão de captura para que ela possa ser correlacionada em ferramentas de monitoramento e observabilidade do lado da Unico. Quando fornecidos, os dados são encaminhados junto com a captura — isso não altera o comportamento de captura do SDK nem a resposta da API.

PrepareInfo attributes

Atributo	Tipo	Obrigatório	Descrição
externalUserId	String	✅	Identificador do usuário no seu sistema. Automaticamente hasheado com SHA-256 antes da transmissão — nunca enviado em texto simples.
useCase	String	—	Identificador do fluxo ou contexto em execução (ex.: "account_opening", "password_recovery"). Transmitido em texto simples.

Implementation

Crie um objeto PrepareInfo e passe-o como terceiro argumento para prepareCamera. Todo o restante do fluxo de captura permanece igual.

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