모니터링 데이터 수집

선택적 구현

모니터링 데이터 수집은 선택 사항입니다. 이를 적용하면 prepareCamera 호출에만 영향을 미치며 — 캡처 플로우의 다른 모든 단계(초기화, 리스너, 결과 처리)는 변경되지 않습니다.

캡처 세션에 사용자 및 플로우 메타데이터를 첨부하면 Unico 측의 모니터링 및 옵저버빌리티 도구에서 상관관계를 파악할 수 있습니다. 데이터가 제공되면 캡처와 함께 전달되며 — SDK의 캡처 동작이나 API 응답을 변경하지 않습니다.

PrepareInfo 속성

속성	타입	필수 여부	설명
externalUserId	String	✅	귀하의 시스템에서 사용자 식별자. 전송 전 SHA-256으로 자동 해시 처리되며 — 평문으로 전송되지 않습니다.
useCase	String	—	실행 중인 플로우 또는 컨텍스트의 식별자(예: "account_opening", "password_recovery"). 평문으로 전송됩니다.

구현

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