문서 캡처

신분증 문서 캡처. 문서 캡처 및 재사용 기능과 결합하면 RG(앞면만 또는 앞뒤 모두), CNH(앞뒤 모두), CPF를 지원합니다.

지원되는 문서 유형의 전체 목록과 열거형 값은 API 레퍼런스 > Enums를 참조하세요.

문서 캡처 시작하기

1단계 — AcessoBioListener 구현

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

메서드	호출 시점
onErrorAcessoBio(errorBio)	SDK 작동 중 오류 발생
onUserClosedCameraManually()	사용자가 카메라를 수동으로 닫음
onSystemClosedCameraTimeoutSession()	세션 시간 제한 도달 — 세션 제한 참조
onSystemChangedTypeCameraTimeoutFaceInference()	얼굴 인식 시간 제한 도달 — 수동 캡처로 전환 — 세션 제한 참조

Kotlin

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

Java

AcessoBioListener callback = new AcessoBioListener() {
  @Override
  public void onErrorAcessoBio(ErrorBio errorBio) { }

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

2단계 — iAcessoBioDocument 구현

iAcessoBioDocument는 문서 캡처 결과 콜백을 처리합니다:

메서드	설명
onSuccessDocument(result)	캡처 성공 — base64(미리보기)와 encrypted(API용 JWT)가 포함된 ResultCamera 반환
onErrorDocument(errorBio)	캡처 실패 — 코드와 설명이 포함된 ErrorBio 반환

Kotlin

val documentListener = object : iAcessoBioDocument {
  override fun onSuccessDocument(result: ResultCamera?) { }
  override fun onErrorDocument(errorBio: ErrorBio?) { }
}

Java

iAcessoBioDocument documentListener = new iAcessoBioDocument() {
  @Override
  public void onSuccessDocument(ResultCamera result) { }

  @Override
  public void onErrorDocument(ErrorBio errorBio) { }
};

3단계 — prepareDocumentCamera 호출

acessoBioBuilder가 초기화되고 두 리스너가 모두 구현된 상태에서, SDK 구성(초기화에서 생성한 UnicoConfig), 원하는 DocumentType, DocumentCameraListener를 전달하여 prepareDocumentCamera를 호출합니다:

• onCameraReady — 카메라가 준비됨; 2단계의 documentListener를 전달하여 open을 호출합니다.
• onCameraFailed — 카메라 준비 실패; 오류 메시지를 처리합니다.

Kotlin

acessoBioBuilder
  .build()
  .prepareDocumentCamera(UnicoConfig(), DocumentType.CNH, object : DocumentCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
      cameraOpener?.open(documentListener)
    }
    override fun onCameraFailed(message: String?) { }
  })

Java

acessoBioBuilder
  .build()
  .prepareDocumentCamera(new UnicoConfig(), DocumentType.CNH, new DocumentCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
      cameraOpener.open(documentListener);
    }

    @Override
    public void onCameraFailed(String message) { }
  });

전체 결과 처리 방법은 결과 수신을 참조하세요.