Dokumentenerfassung

Erfassung von Ausweisdokumenten. Unterstützt RG (nur Vorderseite oder Vorder- und Rückseite), CNH (Vorder- und Rückseite) sowie CPF, in Kombination mit der Funktion Dokumentenerfassung und -wiederverwendung.

Die vollständige Liste der unterstützten Dokumenttypen und ihrer Enum-Werte finden Sie unter API-Referenz > Enums.

Dokumentenerfassung starten

Schritt 1 — AcessoBioListener implementieren

AcessoBioListener verarbeitet die Lebenszyklus-Callbacks des SDK. Implementieren Sie die vier obligatorischen Methoden:

Methode	Wann sie aufgerufen wird
`onErrorAcessoBio(errorBio)`	Ein Fehler ist während des SDK-Betriebs aufgetreten
`onUserClosedCameraManually()`	Der Benutzer hat die Kamera manuell geschlossen
`onSystemClosedCameraTimeoutSession()`	Das Sitzungszeitlimit wurde erreicht — siehe Sitzungslimits
`onSystemChangedTypeCameraTimeoutFaceInference()`	Das Zeitlimit für die Gesichtserkennung wurde erreicht — wechselt zur manuellen Aufnahme — siehe Sitzungslimits

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

Schritt 2 — iAcessoBioDocument implementieren

iAcessoBioDocument verarbeitet die Rückrufe für das Ergebnis der Dokumentenerfassung:

Methode	Beschreibung
`onSuccessDocument(result)`	Erfassung erfolgreich — gibt `ResultCamera` mit `base64` (Vorschau) und `encrypted` (JWT für die API) zurück
`onErrorDocument(errorBio)`	Erfassung fehlgeschlagen — gibt ein `ErrorBio` mit Code und Beschreibung zurück

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

Schritt 3 — prepareDocumentCamera aufrufen

Wenn acessoBioBuilder initialisiert und beide Listener implementiert sind, rufen Sie prepareDocumentCamera auf und übergeben die SDK-Konfiguration (die in Initialisierung erstellte UnicoConfig), den gewünschten DocumentType und einen DocumentCameraListener:

onCameraReady — Kamera ist bereit; rufen Sie open auf und übergeben den documentListener aus Schritt 2.
onCameraFailed — Kameravorbereitung fehlgeschlagen; verarbeiten Sie die Fehlermeldung.

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

Die vollständige Ergebnisverarbeitung finden Sie unter Ergebnis empfangen.