결과 수신

SDK는 open()에 전달된 callback 객체를 통해 캡처 결과를 반환합니다. success 및 error 핸들러 모두 필수입니다.

셀피 캡처

success (셀피)

이미지가 성공적으로 캡처되면 호출됩니다. 다음이 포함된 객체를 수신합니다:

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

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted; // JWT to send to your backend
    },
    error: (error) => {
      console.error(error);
    }
  }
};

encrypted 사용

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

error (셀피)

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

error: (error) => {
  const code = error.getCode();
  const description = error.getDescription();
}

문서 캡처

success (문서)

문서 이미지가 성공적으로 캡처되면 호출됩니다. 다음이 포함된 객체를 수신합니다:

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

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted;
    },
    error: (error) => { /* ... */ }
  }
};

error (문서)

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