메인 콘텐츠로 건너뛰기

사용자 여정

Markdown

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

제품

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

작동 방식

SDK는:

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

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

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

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

메서드호출 시점
onErrorAcessoBioManager(error)SDK 작동 중 오류 발생
onUserClosedCameraManually()사용자가 카메라를 수동으로 닫음
onSystemClosedCameraTimeoutSession()40초 세션 제한 도달
onSystemChangedTypeCameraTimeoutFaceInference()13초 동안 얼굴이 감지되지 않음 — 수동 캡처로 전환
class ViewController: UIViewController, AcessoBioManagerDelegate {
var unicoCheck: AcessoBioManager!

override func viewDidLoad() {
super.viewDidLoad()
unicoCheck = AcessoBioManager(viewController: self)
}

func onErrorAcessoBioManager(_ error: ErrorBio!) { }
func onUserClosedCameraManually() { }
func onSystemClosedCameraTimeoutSession() { }
func onSystemChangedTypeCameraTimeoutFaceInference() { }
}
필수 델리게이트 메서드

위의 4개 델리게이트 메서드는 프로젝트에서 모두 생성해야 합니다 (로직이 없어도). 그렇지 않으면 프로젝트가 컴파일되지 않습니다.

2단계 — AcessoBioSelfieDelegate 구현

여정 캡처 결과 콜백을 처리하도록 메서드를 재정의합니다:

메서드설명
onSuccessSelfie(result)델리게이트 인터페이스에 필요하지만, Unico API 통합에서는 사용되지 않음
onSuccess(result)Unico API 통합에서 필수입니다. 여정이 성공적으로 완료되었습니다 — 검증 결과 조회에 사용되는 processId를 반환
onErrorSelfie(errorBio)캡처 실패 — 오류 세부 정보가 포함된 ErrorBio를 반환
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {

func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
onSuccess는 필수입니다

카메라는 webAppToken으로 열리므로 SDK는 onSuccess를 필요로 합니다. 이것이 없으면 오류 74001로 실패합니다. AcessoBioSelfieDelegate는 onSuccess를 optional로 선언하므로 컴파일러가 이를 검사하지 않으며, 위 예제와 일치하지 않는 시그니처도 컴파일되고 동일하게 실패합니다. 위에 표시된 시그니처를 정확히 그대로 복사하세요.

3단계 — prepareSelfieCamera 및 open 호출

SDK 구성을 전달하며 prepareSelfieCamera를 호출합니다. 카메라가 준비되면 onCameraReady 이벤트가 트리거됩니다 — webAppToken을 전달하며 open() 메서드를 통해 카메라를 엽니다:

webAppToken

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

  • onCameraReady(cameraOpener) — 카메라 준비 완료; open(self, webAppToken:) 호출.
  • onCameraFailed(message) — 카메라 준비 실패(ErrorPrepare는 ErrorBio의 확장입니다).
@IBAction func openCamera(_ sender: Any) {
unicoCheck.build().prepareSelfieCamera(self, config: YourUnicoConfigClass())
}

func onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
cameraOpener.open(self, webAppToken: "your_web_app_token")
}

func onCameraFailed(_ message: ErrorPrepare!) { }

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