Liveness (biometrisches Selfie)

Biometrische Selfie-Aufnahme mit integrierter Liveness-Verifikation. Das SDK führt den Benutzer, bis ein biometrisch gültiges Bild über SmartFrames erfasst wurde, und gibt das Bild als Base64 + JWT zurück.

Fähigkeit

Dieser Aufnahmetyp verwendet die Liveness-Fähigkeit. Eine konzeptuelle Übersicht über die Funktionsweise von Liveness finden Sie auf der Seite zur Liveness-Fähigkeit.

Funktionsweise

Das SDK verwaltet die gesamte Aufnahmesitzung:

1. Öffnet die Kamera mit der SmartFrame-Überlagerung.
2. Führt den Benutzer an, sein Gesicht im Rahmen zu positionieren.
3. Validiert die Liveness — die Sitzung wird nur abgeschlossen, wenn der Benutzer physisch anwesend ist.
4. Gibt ein ResultCamera-Objekt mit base64 und encrypted (JWT) zurück.

Eine Liveness-Aufnahme 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

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

Java

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

  @Override
  public void onUserClosedCameraManually() { }

  @Override
  public void onSystemClosedCameraTimeoutSession() { }

  @Override
  public void onSystemChangedTypeCameraTimeoutFaceInference() { }
};

Schritt 2 — iAcessoBioSelfie implementieren

iAcessoBioSelfie verarbeitet die Ergebnis-Callbacks der Selfie-Aufnahme:

Methode	Beschreibung
onSuccessSelfie(result)	Aufnahme erfolgreich — gibt ResultCamera mit base64 (Vorschau) und encrypted (JWT für die API) zurück
onErrorSelfie(errorBio)	Aufnahme fehlgeschlagen — gibt ein ErrorBio mit Code und Beschreibung zurück

Token-Ablauf

Das Intervall zwischen der Generierung von encrypted und dessen Übermittlung an die API darf 10 Minuten nicht überschreiten.

Kotlin

val selfieListener = object : iAcessoBioSelfie {
  override fun onSuccessSelfie(result: ResultCamera?) { }
  override fun onErrorSelfie(errorBio: ErrorBio?) { }
}

Java

iAcessoBioSelfie selfieListener = new iAcessoBioSelfie() {
  @Override
  public void onSuccessSelfie(ResultCamera result) { }

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

Schritt 3 — prepareCamera aufrufen

Mit initialisiertem unicoCheckCamera und beiden implementierten Listenern rufen Sie prepareCamera auf und übergeben die SDK-Konfiguration sowie einen SelfieCameraListener:

• onCameraReady — Kamera ist bereit; rufen Sie open mit dem selfieListener aus Schritt 2 auf.
• onCameraFailed — Kameravorbereitung fehlgeschlagen; behandeln Sie die Fehlermeldung.

Kotlin

unicoCheckCamera
  .prepareCamera(UnicoConfig(), object : SelfieCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Selfie?) {
      cameraOpener?.open(selfieListener)
    }
    override fun onCameraFailed(message: String?) { }
  })

Java

unicoCheckCamera
  .prepareCamera(new UnicoConfig(), new SelfieCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Selfie cameraOpener) {
      cameraOpener.open(selfieListener);
    }

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

Die vollständige Ergebnisverarbeitung finden Sie unter Ergebnis empfangen.