메인 콘텐츠로 건너뛰기

사용자 여정

Markdown

사용자 여정(User Journeys)은 SDK가 설정된 플로우와 함께 조율하는 다단계 캡처 세션입니다. 예를 들어, 라이브니스 + 위험 점수 + 문서 캡처 + 전자 서명이 포함된 플로우는 단일 세션에서 셀피, 문서 캡처, 서명을 순서대로 실행합니다.

제품

사용 가능한 여정은 통합에 설정된 플로우에 따라 다릅니다. 제품 → 플로우 → 기능의 전체 매핑은 제품을 참조하세요.

작동 방식

SDK는:

  1. 초기화 중에 제공된 플로우 구성을 읽습니다.
  2. 플로우에 필요한 캡처 순서(셀피, 문서, 서명)를 조율합니다.
  3. 여정이 완료되면 onSuccess를 통해 processId가 반환됩니다.

조율은 SDK가 전적으로 처리하므로 앱에서 단계 순서를 직접 구현할 필요가 없습니다.

사용자 여정 시작
1단계 — AcessoBioListener 구현

AcessoBioListener는 SDK 라이프사이클 콜백을 처리합니다. 네 가지 필수 메서드를 구현하세요:

메서드호출 시점
onErrorAcessoBio(errorBio)SDK 작동 중 오류 발생
onUserClosedCameraManually()사용자가 카메라를 수동으로 닫음
onSystemClosedCameraTimeoutSession()세션 시간 제한 도달 — 세션 제한 참조
onSystemChangedTypeCameraTimeoutFaceInference()얼굴 인식 시간 제한 도달 — 수동 캡처로 전환 — 세션 제한 참조
val callback = object : AcessoBioListener {
override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
override fun onUserClosedCameraManually() { }
override fun onSystemClosedCameraTimeoutSession() { }
override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}
2단계 — iAcessoBioSelfie 구현

iAcessoBioSelfie는 여정 캡처 결과 콜백을 처리합니다:

메서드설명
onSuccessSelfie(result)리스너 인터페이스에 필요하지만, Unico API 통합에서는 사용되지 않음
onSuccess(result)여정이 성공적으로 완료되었습니다 — 검증 결과 조회에 사용되는 processId가 포함된 SuccessResult를 반환
onErrorSelfie(errorBio)캡처 실패 — 오류 세부 정보가 포함된 ErrorBio를 반환
val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie {
override fun onSuccessSelfie(result: ResultCamera?) { }
override fun onSuccess(result: SuccessResult) { }
override fun onErrorSelfie(errorBio: ErrorBio?) { }
}
3단계 — prepareCamera 호출

unicoCheckCamera가 초기화되고 두 리스너가 모두 구현된 상태에서 SDK 구성, CameraListener, webAppToken을 전달하여 prepareCamera를 호출합니다:

webAppToken

webAppToken은 백엔드에서 프로세스 생성 시 POST /client/v1/process가 반환하는 process.webAppToken 필드입니다. 프로세스 생성을 참조하세요.

  • onCameraReady — 카메라 준비 완료; cameraListener와 webAppToken을 전달하여 open을 호출합니다.
  • onCameraFailed — 카메라 준비 실패; 오류 메시지를 처리합니다.
unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
cameraOpener?.open(cameraListener, "your_web_app_token")
}

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

전체 결과 처리에 대해서는 결과 수신을 참조하세요.