Captura de documentos

Captura de documentos de identidade. Suporta RG (frente apenas ou frente e verso), CNH (frente e verso) e CPF, quando combinado com a capacidade de Captura e Reutilização de Documentos.

Para a lista completa de tipos de documentos suportados e seus valores de enum, consulte Referência de API > Enums.

Iniciando uma captura de documento

Passo 1 — Implementar AcessoBioListener

AcessoBioListener trata os callbacks de ciclo de vida do SDK. Implemente os quatro métodos obrigatórios:

Método	Quando é chamado
`onErrorAcessoBio(errorBio)`	Ocorreu um erro durante a operação do SDK
`onUserClosedCameraManually()`	O usuário fechou a câmera manualmente
`onSystemClosedCameraTimeoutSession()`	O limite de tempo da sessão foi atingido — consulte Limites de sessão
`onSystemChangedTypeCameraTimeoutFaceInference()`	O limite de tempo de inferência facial foi atingido — alterna para captura manual — consulte Limites de sessão

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() { }
};

Passo 2 — Implementar iAcessoBioDocument

iAcessoBioDocument gerencia os callbacks de resultado da captura de documentos:

Método	Descrição
`onSuccessDocument(result)`	Captura bem-sucedida — retorna `ResultCamera` com `base64` (prévia) e `encrypted` (JWT para a API)
`onErrorDocument(errorBio)`	Captura falhou — retorna um `ErrorBio` com código e descrição

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) { }
};

Passo 3 — Chamar prepareDocumentCamera

Com o acessoBioBuilder inicializado e ambos os listeners implementados, chame prepareDocumentCamera passando a configuração do SDK (o UnicoConfig criado em Inicialização), o DocumentType desejado e um DocumentCameraListener:

onCameraReady — câmera pronta; chame open passando o documentListener do Passo 2.
onCameraFailed — a preparação da câmera falhou; trate a mensagem de erro.

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 o tratamento completo do resultado, consulte Recebendo o resultado.