메인 콘텐츠로 건너뛰기

오류 처리

Web SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. error 콜백은 getCode() 및 getDescription()을 노출하는 ErrorBio 객체를 수신합니다.

prepareCamera 오류
코드설명
73000SDK API 정상 사용 중 알 수 없고 예기치 않은 오류
73001<property>는 필수입니다
73002<property>는 <class>의 인스턴스여야 합니다
73003이름이 <name>인 <class>는 주입할 수 없습니다
73004클래스 유형은 함수 또는 클래스여야 합니다
73005<locale> 로케일을 찾을 수 없습니다
73006텍스트를 찾을 수 없습니다: <text>
73100인터넷에 연결할 수 없습니다
73200Unico SDK JSON 파일을 찾을 수 없습니다
73201Unico SDK JSON 파일을 로드할 수 없습니다
73202Unico SDK JSON 파일이 유효하지 않습니다
73204SDK를 초기화할 수 없습니다 — 빌드 시 setEnvironment를 통해 환경을 구성하세요
73300이 애플리케이션을 인증할 수 없습니다
73301이 애플리케이션을 인증할 수 없습니다
73302인증 토큰을 찾을 수 없습니다
73303현재 호스트가 등록되어 있지 않습니다
73400카메라를 초기화할 수 없습니다
73401이 카메라에 대한 ML 모델을 로드할 수 없습니다
73402사용자 디바이스의 연결 문제로 인해 키를 확인할 수 없습니다
73403이 디바이스/플랫폼/브라우저/버전 조합은 SDK에서 지원되지 않습니다
73404디바이스가 가로 방향입니다. SDK는 세로 방향에서만 사용할 수 있습니다
73405여러 번의 실패한 시도로 인해 디바이스가 차단되었습니다
73406세션이 취소되었습니다 — SDK가 iFrame에서 열렸습니다
73407SDK가 완전히 로드되지 않았습니다
73500세션을 가져올 수 없습니다
73501세션을 가져올 수 없습니다
73502세션 토큰을 찾을 수 없습니다
73600카메라 리소스를 찾을 수 없습니다
73601프로덕션 모드에서 카메라를 시작할 수 없습니다
74000잘못된 16진수
74001객체가 UnicoTheme이 아닙니다
openCamera 오류
코드설명
73700카메라 응답을 파싱할 수 없습니다
73704사용자가 취소 버튼을 눌러 세션을 완료하지 않았습니다
73706카메라 접근이 거부되었습니다 — 사용자가 명시적으로 권한을 거부하거나 디바이스 정책이 차단합니다
73707앱 종료, 절전, OS 알림 또는 백그라운드 전환으로 인해 세션이 취소되었습니다
73708디바이스가 가로 모드여서 세션이 취소되었습니다
73710사용자가 허용된 시간 내에 세션을 완료하지 못해 취소되었습니다
73715모든 안내 이미지가 구성되지 않아 세션이 취소되었습니다
73716SDK가 이 디바이스에서 카메라를 시작할 수 없어 세션이 취소되었습니다
73717사용자가 잠금 상태여서 세션이 취소되었습니다
73718SDK API 정상 사용 중 알 수 없고 예기치 않은 오류
73720개발자가 프로그래밍 방식으로 세션 취소 API를 호출했습니다
73721세션 중 디바이스 방향 변경으로 인해 세션이 취소되었습니다
73722문서가 준비되지 않아 세션이 취소되었습니다
73723다른 세션이 진행 중이어서 세션이 취소되었습니다
73724카메라가 iFrame에서 열려서 세션이 취소되었습니다
73728연결 오류 — HTTPS를 사용하여 연결하세요
73729지원되지 않는 브라우저 — 다른 브라우저에서 여세요
73730활성 라이브니스 세션을 초기화할 수 없습니다 — 알 수 없는 라이선스 오류
73731활성 라이브니스 세션을 초기화할 수 없습니다 — 라이선스 만료
73732활성 라이브니스 세션을 초기화할 수 없습니다 — 오리진이 허용되지 않습니다
73800응답을 암호화할 수 없습니다
73900시스템 정보를 가져올 수 없습니다
공식 오류 카탈로그

위의 코드는 Web SDK 카탈로그를 반영합니다. 공식 크로스 플랫폼 오류 코드 카탈로그는 API 레퍼런스 > 오류 코드에서 확인할 수 있습니다.

콜백 처리
const callback = {
  on: {
    success: (obj) => {
      console.log(obj.base64);
      console.log(obj.encrypted);
    },
    error: (error) => {
      const code = error.getCode();
      const description = error.getDescription();
      // handle error
    }
  }
};
필수 콜백

callback 객체는 필수입니다. 올바르게 구현되지 않으면(success 및 error 이벤트 모두 처리), SDK가 예외를 발생시키고, 처리되지 않으면 사용자의 콘솔에 표시됩니다.

마지막 업데이트 에