--- title: Обработка ошибок canonical: https://developer.unico.io/ru/developers/sdks-and-tools/android/error-handling locale: ru generated_by: markdown-export --- - [/ru/](/ru/) - [SDK и инструменты](/ru/developers/sdks-and-tools/overview) - [Android SDK](/ru/developers/sdks-and-tools/android/requirements) - Обработка ошибок # Обработка ошибок Вся обработка ошибок для 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 */ } }} ``` ``` @Overridepublic 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 > Коды ошибок](/ru/developers/start/error-codes).Последнее обновление 8 окт. 2026 г.**