결과 수신

SDK는 캡처 세션 중 사용된 리스너 인터페이스에 정의된 콜백을 통해 캡처 결과를 반환합니다.

UnicoSelfie

onSuccessSelfie

이미지가 성공적으로 캡처되면 호출됩니다. 다음을 포함한 ResultCamera 객체를 반환합니다:

• base64 — 캡처된 이미지. 애플리케이션에서 미리보기를 표시하는 데 사용할 수 있습니다.
• encrypted — REST API를 통해 생체 인식 검증을 완료하기 위해 백엔드에 전송해야 하는 JWT 페이로드.

@override
void onSuccessSelfie(ResultCamera result) {
  final base64 = result.base64;
  final encrypted = result.encrypted; // JWT to send to your backend
}

encrypted 사용

• encrypted 속성은 Client API를 통해 이미지를 전송하는 데만 사용됩니다. 열거보거나 직렬화해서는 안 됩니다 — 특성이 사전 공지 없이 변경될 수 있습니다. Unico는 부적절한 처리로 인한 손해에 대해 책임을 지지 않습니다.
• base64/encrypted 파일은 기기 품질, 생성된 사진 크기, Unico의 비즈니스 규칙에 따라 크기가 달라질 수 있습니다. 프로그래밍 로직이나 인프라에서 SDK가 생성하는 문자열 크기를 제한하지 마세요.

Base64를 비트맵으로 변환 (Android)

base64를 비트맵으로 변환해야 하는 경우, Android에서는 표준 메서드가 직접 작동하지 않습니다 — 먼저 쉼표(,)에서 문자열을 분할하세요. Base64 문자열을 비트맵 이미지로 변환하여 ImageView에 표시하는 방법을 참조하세요.

onErrorSelfie

캡처 중 오류가 발생하면 호출됩니다. getCode() 및 getDescription()이 포함된 UnicoError 객체를 반환합니다. 전체 오류 코드 목록은 오류 처리를 참조하세요.

@override
void onErrorSelfie(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
}

UnicoDocument

onSuccessDocument

문서 이미지가 성공적으로 캡처되면 호출됩니다. 다음을 포함한 ResultCamera 객체를 반환합니다:

• base64 — 캡처된 이미지. 미리보기를 표시하는 데 사용할 수 있습니다.
• encrypted — 10분 이내에 백엔드에 전송해야 하며 수정하거나 역직렬화해서는 안 되는 JWT 페이로드.

@override
void onSuccessDocument(ResultCamera result) {
  final base64 = result.base64;
  final encrypted = result.encrypted; // JWT to send to your backend
}

onErrorDocument

문서 캡처 중 오류가 발생하면 호출됩니다. UnicoError 객체를 반환합니다. 전체 오류 코드 목록은 오류 처리를 참조하세요.

@override
void onErrorDocument(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
}