메인 콘텐츠로 건너뛰기

오류 처리

Flutter SDK의 모든 오류 처리는 이 섹션에 중앙 집중화되어 있습니다. onErrorUnico, onErrorSelfie, onErrorDocument 콜백은 getCode()와 getDescription()을 노출하는 UnicoError 객체를 수신합니다.

오류 코드
코드설명
73001컨텍스트가 유효하지 않음
73002카메라 열기 권한이 부여되지 않음
73003최소 API는 21 (LOLLIPOP)이어야 함
73004구현 인터페이스 콜백 iAcessoBioSelfie를 찾을 수 없음
73005구현 인터페이스 콜백 iAcessoBioDocument를 찾을 수 없음
73006에뮬레이터에서 카메라를 열 수 없음
73100인터넷에 연결할 수 없음
73200JSON 파일 이름을 입력하세요
73202JSON 파일을 파싱할 수 없음
73300unico 인증 객체를 가져올 수 없음
73301객체를 파싱할 수 없음
73302unico 토큰을 찾을 수 없음
73303현재 호스트가 등록되지 않음
73400카메라를 초기화할 수 없음
73500세션 토큰을 가져올 수 없음 — 서비스 응답 오류
73501객체를 파싱할 수 없음
73502세션 토큰을 가져올 수 없음
73701액티브 라이브니스 임포트를 찾을 수 없음
73702프로덕션 모드에서 액티브 라이브니스를 초기화할 수 없음
73703액티브 라이브니스 세션을 가져올 수 없음
73704사용자가 취소 버튼을 눌러 세션을 완료하지 않음
73705세션이 성공적으로 수행되지 않았으며 FaceScan이 생성되지 않음
73706카메라 접근 거부 — 사용자가 명시적으로 권한을 거부했거나 기기 정책으로 차단됨
73707앱 종료, 절전 모드, OS 알림 또는 백그라운드 전환으로 인해 세션이 취소됨
73708기기가 가로 모드이기 때문에 세션이 취소됨
73709기기가 역 세로 모드이기 때문에 세션이 취소됨
73710지정된 제한 시간 내에 사용자가 세션을 완료하지 못해 세션이 취소됨
73712메모리 부족으로 세션이 취소됨 / 프로덕션이 아닌 앱에는 네트워크가 필요함
73713키 재검증이 필요하여 세션이 취소됨
73714개발자가 구성한 암호화 키가 유효하지 않아 세션이 취소됨
73715모든 안내 이미지가 구성되지 않아 세션이 취소됨
73716SDK가 이 기기에서 카메라를 시작할 수 없어 세션이 취소됨
73717사용자가 잠금 상태에 있어 세션이 취소됨
73718네이티브 API의 일반 사용 중 알 수 없는 예기치 않은 오류
73719사용자가 준비 화면 부제목 메시지를 눌러 세션이 취소됨
73800암호화 키를 빌드할 수 없음
공식 오류 카탈로그

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

콜백 처리
@override
void onErrorUnico(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
  // handle error
}
라이프사이클 콜백

onErrorUnico 외에도 SDK는 다음을 트리거합니다:

  • onUserClosedCameraManually() — 사용자가 카메라를 수동으로 닫음.
  • onSystemClosedCameraTimeoutSession() — 세션이 타임아웃으로 만료됨 (기본값 40초, 최소 40초).
  • onSystemChangedTypeCameraTimeoutFaceInference() — 얼굴 감지가 13초 임계값을 초과하여 캡처가 수동 모드로 전환됨.
마지막 업데이트 에