Manejo de errores
Todo el manejo de errores del SDK de iOS está centralizado en esta sección. Los errores se entregan como un objeto ErrorBio que expone las propiedades code (Int) y desc (String): los errores de captura y de jornada (incluido 74001) llegan a onErrorSelfie, mientras que los errores de configuración e inicialización llegan a onErrorAcessoBioManager.
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 |
74001 | Callback onSuccess no implementado al abrir la cámara con webAppToken |
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.
Enrutamiento de callbacks para cancelaciones y timeouts
Los errores 73704 (usuario canceló) y 73710 (timeout de sesión) no se entregan a través de onErrorAcessoBioManager. Activan directamente los callbacks de ciclo de vida correspondientes:
73704→onUserClosedCameraManually()73710→onSystemClosedCameraTimeoutSession()