Saltar al contenido principal

Recorridos de usuario

Markdown

Los recorridos de usuario son sesiones de captura de múltiples pasos orquestadas por el SDK en conjunto con el flujo configurado. Por ejemplo, un flujo con Detección de Vida + Score de Riesgo + Captura de Documentos + Firma Electrónica ejecuta selfie, captura de documento y firma en una sola sesión.

Productos

Los recorridos disponibles dependen del flujo configurado para tu integración. Consulta Productos para ver el mapeo completo de producto → flujo → capacidad.

Cómo funciona

El SDK:

  1. Lee la configuración del flujo proporcionada durante la inicialización.
  2. Orquesta la secuencia de capturas requeridas para el flujo (selfie, documento, firma).
  3. Devuelve un processId mediante onSuccess cuando el journey finaliza.

La orquestación es gestionada completamente por el SDK — no es necesario implementar la secuencia de pasos en tu aplicación.

Inicio de un recorrido de usuario
Paso 1 — Implementar AcessoBioManagerDelegate

AcessoBioManagerDelegate gestiona los callbacks del ciclo de vida del SDK. Implementa los cuatro métodos obligatorios:

MétodoCuándo se llama
onErrorAcessoBioManager(error)Ocurrió un error durante la operación del SDK
onUserClosedCameraManually()El usuario cerró la cámara manualmente
onSystemClosedCameraTimeoutSession()Se alcanzó el límite de sesión de 40 segundos
onSystemChangedTypeCameraTimeoutFaceInference()No se detectó ningún rostro durante 13 segundos — cambia a captura manual
class ViewController: UIViewController, AcessoBioManagerDelegate {
var unicoCheck: AcessoBioManager!

override func viewDidLoad() {
super.viewDidLoad()
unicoCheck = AcessoBioManager(viewController: self)
}

func onErrorAcessoBioManager(_ error: ErrorBio!) { }
func onUserClosedCameraManually() { }
func onSystemClosedCameraTimeoutSession() { }
func onSystemChangedTypeCameraTimeoutFaceInference() { }
}
Métodos de delegate obligatorios

Los cuatro métodos de delegate mencionados anteriormente deben crearse en tu proyecto (aunque no tengan ninguna lógica). De lo contrario, el proyecto no compilará correctamente.

Paso 2 — Implementar AcessoBioSelfieDelegate

Sobrescribe los métodos para gestionar los callbacks del resultado de captura del recorrido:

MétodoDescripción
onSuccessSelfie(result)Requerido por la interfaz de delegado; no se utiliza en una integración con la Unico API
onSuccess(result)Requerido en una integración con la Unico API. Journey completado exitosamente — devuelve un processId utilizado para consultar los resultados de validación
onErrorSelfie(errorBio)Captura fallida — devuelve un ErrorBio con detalles del error
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {

func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
onSuccess es obligatorio

La cámara se abre con un webAppToken, por lo que el SDK requiere onSuccess: sin él, falla con el error 74001. AcessoBioSelfieDelegate declara onSuccess como opcional, por lo que el compilador no lo verifica, y una firma que no coincida con el ejemplo anterior compila y falla de la misma manera. Copia la firma exactamente como se muestra.

Paso 3 — Llamar a prepareSelfieCamera y open

Llama a prepareSelfieCamera pasando la configuración del SDK. Cuando la cámara esté lista, el evento onCameraReady se dispara — abre la cámara mediante el método open(), pasando el webAppToken:

webAppToken

El webAppToken es el campo process.webAppToken devuelto por POST /client/v1/process al crear el proceso en tu backend. Ver Crear Proceso.

  • onCameraReady(cameraOpener) — la cámara está lista; llama a open(self, webAppToken:).
  • onCameraFailed(message) — la preparación de la cámara falló (ErrorPrepare es una extensión de ErrorBio).
@IBAction func openCamera(_ sender: Any) {
unicoCheck.build().prepareSelfieCamera(self, config: YourUnicoConfigClass())
}

func onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
cameraOpener.open(self, webAppToken: "your_web_app_token")
}

func onCameraFailed(_ message: ErrorPrepare!) { }

Para el manejo completo del resultado, consulta Recibir el resultado.