Обработка ошибок

Markdown

Вся обработка ошибок для Android SDK централизована в этом разделе. Обратный вызов onErrorAcessoBio получает объект ErrorBio с полями code (Int) и description (String).

Обработка обратного вызова

Kotlin
Java

override fun onErrorAcessoBio(error: ErrorBio) {
  when (error.code) {
    73002 -> { /* camera permission denied — redirect to app settings */ }
    73006 -> { /* running on emulator — physical device required */ }
    73100 -> { /* no internet connection */ }
    else -> { /* generic error handling */ }
  }
}

@Override
public void onErrorAcessoBio(ErrorBio error) {
  switch (error.getCode()) {
    case 73002: /* camera permission denied — redirect to app settings */ break;
    case 73006: /* running on emulator — physical device required */ break;
    case 73100: /* no internet connection */ break;
    default: /* generic error handling */
  }
}

Обратные вызовы жизненного цикла

В дополнение к onErrorAcessoBio, SDK также вызывает:

onUserClosedCameraManually() — пользователь вручную закрыл камеру.
onSystemClosedCameraTimeoutSession() — сессия истекла из-за тайм-аута.
onSystemChangedTypeCameraTimeoutFaceInference() — лицо не обнаружено в течение 13 секунд; SDK переключается на ручной захват.

Коды ошибок

Все коды ошибок происходят из enum UnicoException и передаются через ErrorBio(code, message). Поле message содержит точную строку SDK — не изменяйте и не локализуйте её.

Код	Сообщение	Описание
`73001`	`Context invalid`	В SDK передан недействительный контекст Android
`73002`	`Did not grant permission to open camera`	Пользователь отказал в разрешении на использование камеры
`73003`	`The lest API is 21(LOLLIPOP`	Уровень API устройства ниже минимально необходимого (API 21)
`73004`	`Could not find implementation interface callback iAcessoBioSelfie`	Интерфейс `iAcessoBioSelfie` не реализован
`73005`	`Could not find implementation interface callback iAcessoBioDocument`	Интерфейс `iAcessoBioDocument` не реализован
`73006`	`Unable to open camera on emulators`	SDK не работает на эмуляторах — используйте физическое устройство
`73007`	`Unknown and unexpected error in WebApp…`	Общая ошибка WebApp (камера, хранилище, безопасность, сеть)
`73100`	`Unable to connect to internet.`	Нет подключения к интернету
`73200`	`Please inform the config object or json file name`	Объект конфигурации или JSON-файл не указан
`73202`	`Unable to parse json file`	JSON-файл конфигурации повреждён
`73204`	`Unable to initialize the SDK, please configure the environment on setEnviroment method of build`	`setEnvironment()` не был вызван до инициализации
`73300`	`Unable to get unico authentication object`	Не удалось получить объект аутентификации
`73301`	`Unable to parse object`	Не удалось разобрать ответ аутентификации
`73302`	`Could not find the unico token`	Токен аутентификации Unico не найден
`73303`	`Current host is not registered`	Идентификатор пакета не зарегистрирован в SDK Key
`73400`	`Could not initialize camera`	Инициализация камеры не удалась
`73701`	`Could not find active liveness import`	Модуль активной проверки живости не найден
`73703`	`Unable to get active liveness session`	Не удалось получить сессию проверки живости
`73718`	`The Session was cancelled because of an unknown and unexpected error…`	Неизвестная внутренняя ошибка сессии
`73721`	`The Session can't be performed: attempts limit exceeded.`	Сессия отменена — превышен лимит попыток захвата
`73722`	`The Session can't be performed: face alignment timeout.`	Сессия отменена — тайм-аут выравнивания лица
`73726`	`An error happened during video recording`	Ошибка записи видео во время проверки живости
`73727`	`No actions found in a video`	В видео не обнаружено действий для проверки живости
`73740`	`The user pressed the do not consent button and did not complete the Session.`	Пользователь отказался от согласия
`73800`	`Could not build encrypted key.`	Не удалось построить зашифрованный JWT
`73801`	`The Session of SDK was cancelled because of an unknown and unexpected error.`	Неизвестная внутренняя ошибка сессии SDK
`73802`	`The Session was cancelled because of an unknown and unexpected error…`	Сессия отменена — отсутствуют обязательные поля JWT
`73900`	`Erro ao analisar imagem`	Ошибка при анализе захваченного изображения
`73901`	`É necessário implementar a interface AcessoBioListener`	Интерфейс `AcessoBioListener` не реализован
`73902`	`É necessário insirir um valor maior que 40 segundos no método: setTimeoutSession.`	Значение `setTimeoutSession` должно быть больше 40 секунд
`73903`	`Arquivo de configuração corrompido. Verifique o arquivo json e tente novamente.`	Файл конфигурации повреждён — проверьте и повторите попытку
`73904`	`Erro ao finalizar processo`	Ошибка при завершении процесса захвата
`73905`	`Unable to open document camera`	Не удалось открыть камеру для документа
`73906`	`Document type uninformed`	Тип документа не указан
`74001`	`onSuccess: not implemented when using open:webAppToken:`	Обратный вызов `onSuccess` не реализован для User Journey
`74100`	`Could not prepare SDK-S`	Не удалось подготовить компоненты SDK
`74101`	`No URL token was provided.`	URL-токен для пути не указан
`74102`	`Environment type was not specified.`	Среда (`PROD`/`UAT`) не настроена
`737120`	`Unable to initialize liveness`	Не удалось инициализировать активность проверки живости
`737220`	`Capture could not start`	Процесс захвата не удалось запустить
`737320`	`Transaction could not start`	Транзакцию не удалось инициировать
`737321`	`The Session was cancelled because of an unknown and unexpected error. This return value is a catch-all for errors experienced during normal usage of these APIs. Try again.`	Общая ошибка поставщика сессии — повторите попытку

Коды ошибок REST API

Приведённые выше коды являются ошибками callback-ов SDK. Коды ошибок REST API (семейства HTTP-статусов) задокументированы отдельно в разделе Справочник API > Коды ошибок.