Manejo de errores
Todo el manejo de errores del SDK de iOS está centralizado en esta sección. El callback onErrorAcessoBioManager recibe un objeto ErrorBio que expone getCode() y getDescription().
Códigos de error
| Código | Descripción |
|---|---|
73000 | La sesión fue cancelada debido a un error desconocido e inesperado. El SDK de Unico Check utiliza diversas APIs de iOS, incluyendo cámara, almacenamiento, seguridad, red y más — este es un error genérico. |
73001 | Contexto inválido |
73003 | La versión de la API debe ser 13 o más reciente |
73006 | No es posible abrir la cámara en emuladores |
73100 | No es posible conectarse a internet |
73200 | No se encontró el archivo JSON unico_sdk |
73202 | No es posible cargar el archivo JSON unico_sdk |
73203 | No es posible cargar AcessoBioConfigDataSource |
73204 | No es posible inicializar el SDK — configure el entorno mediante setEnvironment en el build |
73300 | No es posible obtener el objeto de autenticación de unico |
73301 | No es posible analizar el objeto de autenticación de unico |
73302 | No se encontró el token de unico |
73701 | No se encontró la importación de liveness activo |
73702 | No es posible inicializar el liveness activo en modo producción |
73703 | No es posible obtener la sesión de liveness activo |
73704 | El usuario presionó el botón de cancelar y no completó la sesión |
73705 | La sesión no se realizó correctamente y no se generó un FaceScan |
73706 | Acceso a la cámara denegado — el usuario denegó explícitamente el permiso o la política del dispositivo lo bloquea |
73707 | La sesión fue cancelada porque la aplicación fue terminada, suspendida, interrumpida por una notificación del SO o enviada al fondo |
73708 | La sesión fue cancelada porque el dispositivo está en modo horizontal |
73709 | La sesión fue cancelada porque el dispositivo está en modo retrato invertido |
73710 | La sesión fue cancelada porque el usuario no pudo completarla dentro del tiempo límite establecido |
73711 | La sesión fue cancelada debido a presión de memoria |
73712 | La sesión fue cancelada porque tu aplicación no está en producción y requiere una conexión de red |
73713 | La sesión fue cancelada porque tu clave necesita ser validada nuevamente |
73714 | La sesión fue cancelada porque la clave de cifrado configurada por el desarrollador no era válida |
73715 | La sesión fue cancelada porque no todas las imágenes de guía estaban configuradas |
73716 | La sesión fue cancelada porque el SDK no pudo iniciar la cámara en este dispositivo |
73717 | La sesión fue cancelada porque el usuario se encontraba en un estado bloqueado |
73718 | Error desconocido e inesperado durante el uso normal de las APIs de iOS |
73719 | La sesión fue cancelada porque el usuario presionó el mensaje de subtexto de la pantalla de preparación |
73720 | La sesión no fue procesada |
73721 | La sesión no puede realizarse: límite de intentos excedido |
73722 | La sesión no puede realizarse: tiempo de espera de alineación facial agotado |
73730 | No es posible inicializar una sesión de liveness activo — error de licencia desconocido |
73731 | No es posible inicializar una sesión de liveness activo — licencia expirada |
73800 | No se pudo construir la clave cifrada |
Catálogo oficial de errores
Los códigos anteriores reflejan el catálogo del SDK de iOS. El catálogo oficial de códigos de error multiplataforma está disponible en Referencia de API > Códigos de error.
Callbacks del ciclo de vida
Además de onErrorAcessoBioManager, el SDK también dispara:
onUserClosedCameraManually()— el usuario cerró la cámara manualmente.onSystemClosedCameraTimeoutSession()— la sesión expiró por tiempo de espera (valor predeterminado 40 s, mínimo 40 s).onSystemChangedTypeCameraTimeoutFaceInference()— la detección facial superó el umbral de 13 s; la captura cambia al modo manual.