메인 콘텐츠로 건너뛰기

오류 처리

MarkdownChatGPTClaude

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초 임계값을 초과하여 캡처가 수동 모드로 전환됨.
마지막 업데이트 에