Dokumentenerfassung

Erfassung von Ausweisdokumenten. Das SDK zeigt einen Rahmen, der dem Benutzer beim Positionieren des Dokuments hilft. Nach dem Positionieren klickt der Benutzer auf die Schaltfläche, um das Foto aufzunehmen.

Keine Inhaltsvalidierung

Das SDK führt keine Validierung des erfassten Inhalts durch.

Verfügbare Dokumentenrahmen

Rahmen	Beschreibung
`DocumentCameraTypes.CPF`	CPF erfassen
`DocumentCameraTypes.CNH`	Offene CNH erfassen
`DocumentCameraTypes.CNH_FRENTE`	Vorderseite der CNH erfassen
`DocumentCameraTypes.CNH_VERSO`	Rückseite der CNH erfassen
`DocumentCameraTypes.RG_FRENTE`	Vorderseite des RG erfassen
`DocumentCameraTypes.RG_VERSO`	Rückseite des RG erfassen
`DocumentCameraTypes.OUTROS("descrição")`	Generischer Rahmen für beliebige andere Dokumente

Generischer Rahmen

Wenn Sie ein Dokument erfassen müssen, für das kein spezifischer Rahmen vorhanden ist (z. B. RNE), verwenden Sie DocumentCameraTypes.OUTROS("description") — ein generischer, rechteckiger Rahmen, der für jede Erfassung verwendet werden kann.

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

Dokumentenerfassung starten

Schritt 1 — UnicoListener implementieren

UnicoListener verarbeitet die SDK-Lifecycle-Callbacks. Implementieren Sie die vier obligatorischen Methoden:

Methode	Wann sie aufgerufen wird
`onErrorUnico(error)`	Ein Fehler ist während des SDK-Betriebs aufgetreten
`onUserClosedCameraManually()`	Der Benutzer hat die Kamera manuell geschlossen
`onSystemClosedCameraTimeoutSession()`	Das 40-Sekunden-Sitzungslimit wurde erreicht
`onSystemChangedTypeCameraTimeoutFaceInference()`	Kein Gesicht für 13 Sekunden erkannt — wechselt zur manuellen Aufnahme

class _MyHomePageState extends State<MyHomePage> implements UnicoListener {
  late UnicoCheckBuilder _unicoCheck;

  @override
  void onErrorUnico(UnicoError error) {}

  @override
  void onUserClosedCameraManually() {}

  @override
  void onSystemClosedCameraTimeoutSession() {}

  @override
  void onSystemChangedTypeCameraTimeoutFaceInference() {}
}

Obligatorische Listener-Methoden

Alle vier oben genannten Listener-Methoden müssen in Ihrem Projekt erstellt werden (auch ohne jegliche Logik). Andernfalls wird das Projekt nicht erfolgreich kompiliert.

Schritt 2 — Dokument-Listener implementieren

Fügen Sie die Dokument-Rückrufe zu Ihrer State-Klasse hinzu:

Methode	Beschreibung
`onSuccessDocument(ResultCamera resultCamera)`	Erfassung erfolgreich — gibt `ResultCamera` mit `base64` (Vorschau) und `encrypted` (JWT für die API) zurück
`onErrorDocument(UnicoError error)`	Erfassung fehlgeschlagen — gibt einen `UnicoError` mit Code und Beschreibung zurück

@override
void onSuccessDocument(ResultCamera resultCamera) { }

@override
void onErrorDocument(UnicoError error) { }

Schritt 3 — openCameraDocument aufrufen

Die Methode openCameraDocument() wird über das Objekt bereitgestellt, das mit einer Instanz der Klasse UnicoCheck erstellt wurde. Sie erwartet:

Eine JSON-Datei mit den Anmeldedaten, die im Schritt zur Einrichtung der Anmeldedaten erstellt wurde;
Den zu erfassenden Dokumenttyp (Enum DocumentType);
Den in Schritt 2 konfigurierten Listener.

Beispiel mit der offenen CNH:

_unicoCheck.build().openCameraDocument(
  jsonFileName: androidJsonFileName,
  documentType: DocumentType.CNH,
  listener: this,
);

Die vollständige Ergebnisverarbeitung finden Sie unter Ergebnis empfangen.