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

- [/ru/](/ru/)
- [SDK и инструменты](/ru/developers/sdks-and-tools/overview)
- [iOS SDK](/ru/developers/sdks-and-tools/ios/requirements)
- Обработка ошибок

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

Вся обработка ошибок iOS SDK централизована в этом разделе. Ошибки передаются в виде объекта `ErrorBio` со свойствами `code` (`Int`) и `desc` (`String`): ошибки захвата и сценария (включая `74001`) приходят в `onErrorSelfie`, а ошибки конфигурации и инициализации — в `onErrorAcessoBioManager`.

Коды ошибок
| Код | Описание |
| --- | --- |
| `73000` | Сеанс был отменён из-за неизвестной и непредвиденной ошибки. Unico Check SDK использует различные iOS API, включая камеру, хранилище, безопасность, сеть и другие — это общая категория. |
| `73001` | Недействительный контекст |
| `73003` | Версия API должна быть 13 или новее |
| `73006` | Невозможно открыть камеру на эмуляторах |
| `73100` | Невозможно подключиться к интернету |
| `73200` | Не удалось найти JSON-файл unico_sdk |
| `73202` | Невозможно загрузить JSON-файл unico_sdk |
| `73203` | Невозможно загрузить `AcessoBioConfigDataSource` |
| `73204` | Невозможно инициализировать SDK — настройте среду через `setEnvironment` при сборке |
| `73300` | Невозможно получить объект аутентификации unico |
| `73301` | Невозможно разобрать объект аутентификации unico |
| `73302` | Не удалось найти токен unico |
| `73701` | Не удалось найти импорт активного liveness |
| `73702` | Невозможно инициализировать активный liveness в производственном режиме |
| `73703` | Невозможно получить сеанс активного liveness |
| `73704` | Пользователь нажал кнопку отмены и не завершил сеанс |
| `73705` | Сеанс  не был выполнен успешно и FaceScan не был сгенерирован |
| `73706` | Доступ к камере запрещён — пользователь явно отказал в разрешении или политика устройства блокирует его |
| `73707` | Сеанс был отменён из-за завершения работы приложения, перехода в спящий режим, уведомления ОС или перехода в фоновый режим |
| `73708` | Сеанс был отменён, так как устройство находится в горизонтальной ориентации |
| `73709` | Сеанс был отменён, так как устройство находится в перевёрнутом портретном режиме |
| `73710` | Сеанс был отменён, так как пользователь не смог завершить его в отведённое время |
| `73711` | Сеанс был отменён из-за нехватки памяти |
| `73712` | Сеанс был отменён, так как ваше приложение не находится в производственной среде и требует сетевого подключения |
| `73713` | Сеанс был отменён, так как ваш ключ требует повторной проверки |
| `73714` | Сеанс был отменён, так как настроенный разработчиком ключ шифрования недействителен |
| `73715` | Сеанс был отменён, так как не все направляющие изображения были настроены |
| `73716` | Сеанс был отменён, так как SDK не смог запустить камеру на этом устройстве |
| `73717` | Сеанс был отменён, так как пользователь находится в состоянии блокировки |
| `73718` | Неизвестная и непредвиденная ошибка при обычном использовании iOS API |
| `73719` | Сеанс был отменён, так как пользователь нажал на подтекст экрана подготовки |
| `73720` | Сеанс не был обработан |
| `73721` | Сеанс не может быть выполнен: превышен лимит попыток |
| `73722` | Сеанс не может быть выполнен: истекло время выравнивания лица |
| `73730` | Невозможно инициализировать сеанс активного liveness — неизвестная ошибка лицензии |
| `73731` | Невозможно инициализировать сеанс активного liveness — лицензия истекла |
| `73800` | Не удалось создать зашифрованный ключ |
| `74001` | Колбэк `onSuccess` не реализован при открытии камеры с `webAppToken` |

Официальный каталог ошибокКоды выше отражают каталог iOS SDK. Официальный кросс-платформенный каталог кодов ошибок доступен в разделе [Справочник API > Коды ошибок](/ru/developers/start/error-codes).

Обратные вызовы жизненного цикла
В дополнение к `onErrorAcessoBioManager`, SDK также вызывает:

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

Маршрутизация колбэков для отмен и таймаутовОшибки `73704` (пользователь отменил) и `73710` (таймаут сессии) **не** доставляются через `onErrorAcessoBioManager`. Они напрямую вызывают соответствующие lifecycle-колбэки:

- `73704` → `onUserClosedCameraManually()`
- `73710` → `onSystemClosedCameraTimeoutSession()`

Последнее обновление **23 окт. 2026 г.**