Capture de document

Capture de documents d'identité. Prend en charge le RG (face avant uniquement ou recto-verso), le CNH (recto-verso) et le CPF, en combinaison avec la capacité Capture et réutilisation de documents.

Pour la liste complète des types de documents pris en charge et leurs valeurs d'énumération, consultez Référence API > Enums.

Démarrer une capture de document

Étape 1 — Implémenter AcessoBioListener

AcessoBioListener gère les callbacks du cycle de vie du SDK. Implémentez les quatre méthodes obligatoires :

Méthode	Quand elle est appelée
`onErrorAcessoBio(errorBio)`	Une erreur s'est produite pendant l'opération du SDK
`onUserClosedCameraManually()`	L'utilisateur a fermé la caméra manuellement
`onSystemClosedCameraTimeoutSession()`	La limite de durée de session a été atteinte — voir Limites de session
`onSystemChangedTypeCameraTimeoutFaceInference()`	La limite de durée d'inférence faciale a été atteinte — bascule vers la capture manuelle — voir Limites de session

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

Étape 2 — Implémenter iAcessoBioDocument

iAcessoBioDocument gère les callbacks du résultat de capture de document :

Méthode	Description
`onSuccessDocument(result)`	Capture réussie — retourne `ResultCamera` avec `base64` (aperçu) et `encrypted` (JWT pour l'API)
`onErrorDocument(errorBio)`	Capture échouée — retourne un `ErrorBio` avec le code et la description

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

Étape 3 — Appeler prepareDocumentCamera

Une fois acessoBioBuilder initialisé et les deux listeners implémentés, appelez prepareDocumentCamera en passant la configuration SDK (le UnicoConfig créé lors de l'Initialisation), le DocumentType souhaité et un DocumentCameraListener :

onCameraReady — la caméra est prête ; appelez open en passant le documentListener de l'étape 2.
onCameraFailed — la préparation de la caméra a échoué ; gérez le message d'erreur.

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

Pour la gestion complète du résultat, consultez Réception du résultat.