Collecte de données de monitoring

Implémentation optionnelle

La collecte de données de monitoring est optionnelle. Si vous l'adoptez, seul l'appel à prepareCamera est concerné — toutes les autres étapes du flux de capture (initialisation, listeners, gestion du résultat) restent inchangées.

Associez des métadonnées utilisateur et de flux à une session de capture afin qu'elles puissent être corrélées dans les outils de monitoring et d'observabilité côté Unico. Lorsqu'elles sont fournies, les données sont transmises avec la capture — elles ne modifient pas le comportement de capture du SDK ni la réponse de l'API.

Attributs de PrepareInfo

Attribut	Type	Requis	Description
externalUserId	String	✅	Identifiant de l'utilisateur dans votre système. Automatiquement haché avec SHA-256 avant la transmission — jamais envoyé en clair.
useCase	String	—	Identifiant du flux ou du contexte en cours d'exécution (ex. : "account_opening", "password_recovery"). Transmis en clair.

Implémentation

Créez un objet PrepareInfo et passez-le comme troisième argument à prepareCamera. Tout le reste du flux de capture reste identique.

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