---
title: Обработка ошибок
canonical: https://developer.unico.io/ru/dual-api/developers/sdks-and-tools/android/error-handling
locale: ru
generated_by: markdown-export
---

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

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

### Kotlin

  ```kotlin
  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 */ }
    }
  }
  ```

### Java

  ```java
  @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.` | Общая ошибка поставщика сессии — повторите попытку |

:::secondary[Коды ошибок REST API]
Приведённые выше коды являются ошибками callback-ов SDK. Коды ошибок REST API (семейства HTTP-статусов) задокументированы отдельно в разделе [Справочник API > Коды ошибок](/dual-api/developers/api-reference/error-codes).
:::