Captura de documentos

Captura de documentos de identidad. Soporta RG (solo frente o frente y dorso), CNH (frente y dorso) y CPF, cuando se combina con la capacidad de Captura y Reutilización de Documentos.

Para la lista completa de tipos de documentos soportados y sus valores de enumeración, consulte Referencia de API > Enumeraciones.

Iniciar una captura de documento

Paso 1 — Implementar AcessoBioListener

AcessoBioListener gestiona los callbacks del ciclo de vida del SDK. Implemente los cuatro métodos obligatorios:

Método	Cuándo se llama
`onErrorAcessoBio(errorBio)`	Ocurrió un error durante la operación del SDK
`onUserClosedCameraManually()`	El usuario cerró la cámara manualmente
`onSystemClosedCameraTimeoutSession()`	Se alcanzó el límite de tiempo de sesión — ver Límites de sesión
`onSystemChangedTypeCameraTimeoutFaceInference()`	Se alcanzó el límite de tiempo de inferencia facial — cambia a captura manual — ver Límites de sesión

Kotlin
Java

val callback = object : AcessoBioListener {
  override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
  override fun onUserClosedCameraManually() { }
  override fun onSystemClosedCameraTimeoutSession() { }
  override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
}

AcessoBioListener callback = new AcessoBioListener() {
  @Override
  public void onErrorAcessoBio(ErrorBio errorBio) { }

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

Paso 2 — Implementar iAcessoBioDocument

iAcessoBioDocument gestiona los callbacks del resultado de la captura de documentos:

Método	Descripción
`onSuccessDocument(result)`	Captura exitosa — devuelve `ResultCamera` con `base64` (vista previa) y `encrypted` (JWT para la API)
`onErrorDocument(errorBio)`	Captura fallida — devuelve un `ErrorBio` con código y descripción

Kotlin
Java

val documentListener = object : iAcessoBioDocument {
  override fun onSuccessDocument(result: ResultCamera?) { }
  override fun onErrorDocument(errorBio: ErrorBio?) { }
}

iAcessoBioDocument documentListener = new iAcessoBioDocument() {
  @Override
  public void onSuccessDocument(ResultCamera result) { }

  @Override
  public void onErrorDocument(ErrorBio errorBio) { }
};

Paso 3 — Llamar a prepareDocumentCamera

Con acessoBioBuilder inicializado y ambos listeners implementados, llame a prepareDocumentCamera pasando la configuración del SDK (el UnicoConfig creado en Inicialización), el DocumentType deseado y un DocumentCameraListener:

onCameraReady — la cámara está lista; llame a open pasando el documentListener del Paso 2.
onCameraFailed — la preparación de la cámara falló; gestione el mensaje de error.

Kotlin
Java

acessoBioBuilder
  .build()
  .prepareDocumentCamera(UnicoConfig(), DocumentType.CNH, object : DocumentCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
      cameraOpener?.open(documentListener)
    }
    override fun onCameraFailed(message: String?) { }
  })

acessoBioBuilder
  .build()
  .prepareDocumentCamera(new UnicoConfig(), DocumentType.CNH, new DocumentCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
      cameraOpener.open(documentListener);
    }

    @Override
    public void onCameraFailed(String message) { }
  });

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