오류 처리
iOS SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. onErrorAcessoBioManager 콜백은 getCode()와 getDescription()을 노출하는 ErrorBio 객체를 수신합니다.
오류 코드
| 코드 | 설명 |
|---|---|
73000 | 알 수 없고 예기치 않은 오류로 인해 세션이 취소되었습니다. Unico Check SDK는 카메라, 저장소, 보안, 네트워킹 등 다양한 iOS API를 활용합니다 — 이는 모든 오류를 포괄하는 코드입니다. |
73001 | 컨텍스트가 유효하지 않음 |
73003 | API 버전은 13 이상이어야 합니다 |
73006 | 에뮬레이터에서 카메라를 열 수 없음 |
73100 | 인터넷에 연결할 수 없음 |
73200 | unico_sdk JSON 파일을 찾을 수 없음 |
73202 | unico_sdk JSON 파일을 로드할 수 없음 |
73203 | AcessoBioConfigDataSource를 로드할 수 없음 |
73204 | SDK를 초기화할 수 없음 — 빌드 시 setEnvironment를 통해 환경을 구성하세요 |
73300 | unico 인증 객체를 가져올 수 없음 |
73301 | unico 인증 객체를 파싱할 수 없음 |
73302 | unico 토큰을 찾을 수 없음 |
73701 | 활성 liveness 가져오기를 찾을 수 없음 |
73702 | 프로덕션 모드에서 활성 liveness를 초기화할 수 없음 |
73703 | 활성 liveness 세션을 가져올 수 없음 |
73704 | 사용자가 취소 버튼을 눌러 세션을 완료하지 않았습니다 |
73705 | 세션이 성공적으로 수행되지 않아 FaceScan이 생성되지 않았습니다 |
73706 | 카메라 접근이 거부됨 — 사용자가 명시적으로 권한을 거부했거나 기기 정책에 의해 차단되었습니다 |
73707 | 앱 종료, 절전 모드, OS 알림 또는 백그라운드 전환으로 인해 세션이 취소되었습니다 |
73708 | 기기가 가로 모드이기 때문에 세션이 취소되었습니다 |
73709 | 기기가 역 세로 모드이기 때문에 세션이 취소되었습니다 |
73710 | 허용된 제한 시간 내에 사용자가 세션을 완료하지 못해 취소되었습니다 |
73711 | 메모리 부족으로 인해 세션이 취소되었습니다 |
73712 | 앱이 프로덕션 상태가 아니어서 네트워크 연결이 필요하여 세 션이 취소되었습니다 |
73713 | 키 재검증이 필요하여 세션이 취소되었습니다 |
73714 | 개발자가 구성한 암호화 키가 유효하지 않아 세션이 취소되었습니다 |
73715 | 모든 안내 이미지가 구성되지 않아 세션이 취소되었습니다 |
73716 | SDK가 이 기기에서 카메라를 시작할 수 없어 세션이 취소되었습니다 |
73717 | 사용자가 잠금 상태에 있어 세션이 취소되었습니다 |
73718 | iOS API 정상 사용 중 알 수 없고 예기치 않은 오류 |
73719 | 사용자가 준비 화면의 하위 텍스트 메시지를 눌러 세션이 취소되었습니다 |
73720 | 세션이 처리되지 않았습니다 |
73721 | 세션을 수행할 수 없습니다: 시도 횟수 초과 |
73722 | 세션을 수행할 수 없습니다: 얼굴 정렬 시간 초과 |
73730 | 활성 liveness 세션을 초기화할 수 없음 — 알 수 없는 라이선스 오류 |
73731 | 활성 liveness 세션을 초기화할 수 없음 — 라이선스 만료됨 |
73800 | 암호화된 키를 생성할 수 없음 |
공식 오류 카탈로그
위의 코드는 iOS SDK 카탈로그를 반영합니다. 공식 크로스 플랫폼 오류 코드 카탈로그는 API 참조 > 오류 코드에서 확인할 수 있습니다.
수명 주기 콜백
onErrorAcessoBioManager 외에도 SDK는 다음을 트리거합니다:
onUserClosedCameraManually()— 사용자가 카메라를 수동으로 닫았습니다.onSystemClosedCameraTimeoutSession()— 시간 초과로 인해 세션이 만료되었습니다 (기본값 40초, 최소 40초).onSystemChangedTypeCameraTimeoutFaceInference()— 얼굴 감지가 13초 임계값을 초과했습니다; 캡처가 수동 모드로 전환됩니다.