Monitoring-Datenerfassung

Optionale Implementierung

Monitoring-Datenerfassung ist optional. Wenn Sie sie verwenden, ist nur der prepareCamera-Aufruf betroffen — jeder andere Schritt im Aufnahmeablauf (Initialisierung, Listener, Ergebnisverarbeitung) bleibt unverändert.

Fügen Sie einer Aufnahmesitzung Benutzer- und Ablaufmetadaten hinzu, damit sie in Monitoring- und Observability-Tools auf Seite von Unico korreliert werden können. Wenn die Daten angegeben werden, werden sie zusammen mit der Aufnahme weitergeleitet — sie ändern weder das Aufnahmeverhalten des SDK noch die API-Antwort.

PrepareInfo attributes

Attribut	Typ	Erforderlich	Beschreibung
externalUserId	String	✅	Benutzerkennung in Ihrem System. Wird vor der Übertragung automatisch mit SHA-256 gehasht — wird niemals im Klartext gesendet.
useCase	String	—	Kennung für den ausgeführten Ablauf oder Kontext (z. B. "account_opening", "password_recovery"). Wird im Klartext übertragen.

Implementation

Erstellen Sie ein PrepareInfo-Objekt und übergeben Sie es als drittes Argument an prepareCamera. Alles andere im Aufnahmeablauf bleibt gleich.

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